home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 008 / deutex33.arj / DTEXMAN3.TXT < prev    next >
Text File  |  1995-02-22  |  170KB  |  5,149 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6. ____________                   __________________________
  7. \           \                  \                      / /
  8. |  _______   \                  \_______     ________/ /
  9. |  |\_____\   \                  \______\   / \______\/
  10. |  | |    |   |\                        |   | /
  11. |  | |    |   || __________ ____  ____  |   | | __________ _____   ____
  12. |  | |    |   || \ _____/ / \ / \ \ / \ |   | | \ _____/ /| \  /   \ / \
  13. |  | |    |   || | |\___\/  | |/  | |/  |   | | | |\___\/  \ \ \  / / /
  14. |  | |  _/    || | |_|____  | ||  | ||  |   | | | |_|___    \ \ \/ / /
  15. |  | |_/   __/ | | ____/ /  | ||  | ||  |   | | | ___/ /     \/    \/
  16. |  |/   __/  __/ | |\__\/   | ||  | ||  |   | | | |\_\/      /  /\  \
  17. \      /  __/    | |_|_____ | \|__/ ||  |   | | | |_|_____  /  / |\  \
  18.  \    / _/       /______/ / /_______/|  /___| | /______/ / /__/ /\ \__\
  19.   \  / /         \______\/  \________/  \____\| \______\/  \__\/  \|__|
  20.    \/ /
  21.     \/                   **********************************************/
  22.                                 ------------------------------------->/
  23.                     *************************************************/
  24.                                           ------------------------->/
  25.               *****************************************************/
  26.                       ------------------------------------------->/
  27.           *******************************************************/
  28.                                  ------------------------------>/
  29.      **********************************************************/
  30. ______________________________________________________________/
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                             DEUTEX/DEUSF 3.3
  39.                               February 1995
  40.  
  41.                       WAD composition tool for DOOM
  42.            Copyright (c) Olivier Montanuy 1994/95
  43.                          (montanuy@dmi.ens.fr)
  44.  
  45.                      Manual Edited by Kevin McGrail
  46.                       (74107.1254@compuserve.com)
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ------------------------ Data Utility License -------------------------
  71. DOOM(tm) is a trademark of Id Software, Inc.
  72. The DOOM characters and the Id Software logo are trademarks of Id
  73. Software, Inc. DOOM Copyright (c) 1993. Id Software Inc. All rights
  74. reserved. This utility product is not a product of Id Software, Inc.
  75. and has not been approved by Id Software, Inc. Id Software will not
  76. provide technical support for this product. The purchaser of this
  77. utility product may not distribute for money or other consideration
  78. any software data created and/or modified by the use of this utility
  79. product.
  80. -----------------------------------------------------------------------
  81.  
  82.  
  83. ***************************** DISCLAIMER *****************************
  84.  
  85.     I will not accept liability for damages resulting from the use of
  86.     this program. DeuTex and DeuSF are programmed in a very secure way,
  87.     to limit the risk of bugs. They have as few tricky optimisations as
  88.     possible. DeuTex and DeuSF use only basic level commands, and don't
  89.     contain any Logical bomb or other tricks. They should work on all
  90.     platforms, but this can never be 100% certain. The source code is
  91.     available on request (for serious people only).
  92.  
  93.  Legalese:
  94.             Read the license information at the end of this manual.
  95.             DeuTex/DeuSF are freeware and Copyright (c) O.Montanuy 1994,1995.
  96.  
  97.  Distribution:
  98.             DeuSF can be freely distributed.
  99.             DeuTex cannot be distributed for *any* commercial purpose,
  100.             with the sole exception of Compuserve download charges.
  101.  
  102.  
  103. ************************** CONVIVIALITY ******************************
  104.  
  105. DeuTex and DeuSF have no human interface.
  106. If you can't do without, get WinTex, the Windows Shell for DeuTex
  107. DeuTex is meant to be run from a batch creation file (e.g. make.bat).
  108. DeuSF should be run from a batch installation file (e.g. install.bat).
  109.  
  110. ***********************************************************************
  111.  
  112.  
  113. +   *NEW* - Lines begining with a '+' indicate information added since
  114. +   the manual for DeuTex v3.1 came out.
  115. +   DeuTex 3.0 and above is not entirely compatible with previous
  116. +   versions. A few things were much too dirty...
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.                                                                   page i
  133.  
  134.  
  135.  
  136.  
  137. ************************** Table of Contents ***************************
  138.  
  139.  
  140. Data Utility License                                             i
  141. Disclaimer                                                       i
  142. Conviviality                                                     i
  143. Table of Contents                                               ii
  144. Features                                                         v
  145. What's  New?                                                    vi
  146.  
  147.  
  148.                  ----------------------------
  149.              *** [PART ONE]   GETTING STARTED ***                 1
  150.                  ----------------------------
  151.  
  152.  
  153.  
  154. Chapter 1         OVERVIEW                                        1
  155.  
  156.  
  157.            A) What is DeuTex?                                     2
  158.            B) Installation                                        2
  159.            C) Directories and DeuTex                              4
  160.            D) What do I need?                                     4
  161.            E) What do I do?                                       4
  162.        F) What is DeuSF for?                                  5
  163.            G) What are the Palettes For?                          5
  164.  
  165.  
  166. Chapter 2         TEST-ME or What's inside TRINITY.WAD?           7
  167.  
  168.  
  169.            A) About Test-Me                                       7
  170.            B) Listing the Directory                               7
  171.            C) Decomposing TRINITY.WAD                             7
  172.            D) Recomposing TRINITY.WAD as TRINIDAD.WAD             8
  173.            E) Customizing TRINITY.WAD                             8
  174.  
  175.  
  176. Chapter 3         WORKING WITH WADS                               9
  177.  
  178.  
  179.                     INTRODUCTION                                  9
  180.  
  181.            A) How to Decompose a PWAD                             9
  182.            B) How to Create a PWAD with new TEXTURES             10
  183.            C) How to Create a PWAD with new SPRITES and FLATS    11
  184.  
  185.                  1) Sprite and Flat Replacement                  11
  186.                  2) Changing the Number of Sprite Viewpoints     12
  187.  
  188.            D) How to Create a PWAD with new SOUNDS               14
  189.  
  190.  
  191. Chapter 4         VBDEUTEX                                       15
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                                                                  page ii
  199.  
  200.  
  201.  
  202.  
  203. ********************** Table of Contents (cont) ************************
  204.  
  205.  
  206.  
  207.                  -----------------------------
  208.              *** [PART TWO]   DETAILS, DETAILS ***             16
  209.                  -----------------------------
  210.  
  211.  
  212.  
  213. Chapter 5         DIRECTORY STRUCTURE                          16
  214.  
  215.  
  216.            A) \Levels                                          17
  217.            B) \Lumps                                           18
  218.            C) \Textures                                        19
  219.            D) \Sounds                                          20
  220.            E  \Graphics                                        20
  221.            F) \Sprites                                         21
  222.            G) \Flats                                           21
  223.            H) \Patches                                         22
  224.  
  225.  
  226.  
  227. Chapter 6         DEUTEX COMMANDS                              23
  228.  
  229.  
  230.            A) Complete Command Reference                       23
  231.            B) Help Commands                                    23
  232.            C) Optional Commands                                23
  233.            D) Commands to Compose or Decompose WADS            25
  234.            E) Commands for merging PWADS into the Main IWAD    26
  235.  
  236.  
  237.  
  238. Chapter 7         DEUSF COMMANDS                               28
  239.  
  240.  
  241.            A) Overview                                         28
  242.            B) Complete Command Reference                       29
  243.            C) Help Commands                                    29
  244.            D) Optional Commands                                30
  245.            E) Mandatory Commands                               30
  246.  
  247.  
  248.  
  249. Chapter 8         FORMATS                                      31
  250.  
  251.  
  252.            A) The WAD Creation Directive (WADINFO.TXT)         31
  253.  
  254.                  1) Overview                                   31
  255.                  2) WADINFO.TXT format                         32
  256.                  3) An example WADINFO.TXT Listing             36
  257.  
  258.            B) The Texture Definition File (TEXTURE1.TXT)       39
  259.  
  260.                  1) Overview                                   39
  261.                  2) An Example TEXTURE1.TXT Listing            41
  262.  
  263.  
  264.                                                                 page iii
  265.  
  266.  
  267.  
  268.  
  269. ********************** Table of Contents (cont) ************************
  270.  
  271.  
  272.  
  273.  
  274.                  ---------------------------
  275.              *** [PART THREE]   ALL THE REST ***                  43
  276.                  ---------------------------
  277.  
  278.  
  279.  
  280.  
  281. Chapter 9         NECESSARY STUFF                                 43
  282.  
  283.  
  284.  
  285.            A) License Agreement                                   43
  286.            B) Legal Stuff                                         44
  287.            C) Where to get DeuTex/DeuSF                           45
  288.            D) Version Information                                 46
  289.            E) Known Problems                                      47
  290.            F) Thanx                                               48
  291.            G) Final Words                                         50
  292.  
  293.  
  294.  
  295. APPENDICES
  296.  
  297.  
  298.            I) Switch Textures in DOOM.WAD                         51
  299.           II) Animated Wall Textures in DOOM.WAD                  56
  300.          III) Sound Names for DOOM                                58
  301.  
  302.                  A) Sounds found in BOTH DOOM I and DOOM II       58    
  303.                  B) Sounds found ONLY in DOOM II                  60
  304.                  C) Converting DMAUD Sounds for DeuTex            62
  305.  
  306.           IV) DeuTex and DeuSF Command Summaries                  64
  307.  
  308.                  A) DeuTex Commands                               64
  309.                  B) DeuSF Commands                                65
  310.  
  311.  
  312.  
  313. AFTERWORD
  314.             TRINITY.WAD - How I Made It by Steve McCrea           66
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.                                                                  page iv
  331.  
  332.  
  333.  
  334.  
  335. ****************************** FEATURES *******************************
  336.  
  337.                              ------------
  338.                                 DeuTex
  339.                              ------------
  340.  
  341. DeuTex stands stands for DEU's Texture Companion, because it used to
  342. deal only with DOOM textures. Now it can do much more!
  343. DEU is a DOOM level editor by Brendon Wyber and Raphael Quinet, and
  344. DeuTex was originally derived from the code of DEU 5.21. DeuTex uses
  345. various contributions for particular file formats.
  346.  
  347. DEUTEX Features:
  348.  
  349. -  Ported on all DOOM environement (DOS,OS/2,Linux,SGIx,Unix)
  350. -  Reverse engineer existing PWADs.
  351. -  Compose your own wall Textures, by reusing existing DOOM
  352.    Patches or adding your own Patches as .BMP or .GIF files.
  353. -  Load Sounds as .WAV, .AU or .VOC files.
  354. -  Load PC Speaker Sounds as a serial of number (in text).
  355. -  Load music entries as .MUS files. (from MIDItoMUS)
  356. -  Add your own floors.
  357. -  Add your own Sprites.
  358. -  Simple WAD creation directives from a text file.
  359. -  Simple directory structure for the resources.
  360. -  Work in batch mode, like a compiler.
  361. -  A Windows shell can be used to make your life easier.
  362. -  Compatible with Level editors (like DEU).
  363. -  Merge a PWAD into the main IWAD, recreating the WAD directory,
  364.    so that ANY or ALL kinds of Sprites and/or Flats can be defined,
  365.    while distributing only the changed ones in the PWAD.
  366. -  Extract Graphics, Bitmaps and Lumps out of your favorite PWAD,
  367.    for contemplation or reuse. (WITH WAD AUTHOR AGREEMENT ONLY!)
  368. -  Check your PWAD for errors in Texture definitions.
  369. -  Create animated walls with (almost) any sequence of pictures.
  370. -  Create a non repeating sky Texture.
  371.  
  372.                              -------------
  373.                                  DEUSF
  374.                              -------------
  375.  
  376. DeuSF stands for DEU Sprite and Flats. It is mainly used to
  377. compensate a bug in DOOM Sprite and Flats handling.
  378.  
  379. DeuSF was inspired by DMADDS by Bernd Kreimeier, but is more powerful
  380. and much cleaner. Like DMADDS, DeuSF compensates for a bug in DOOM
  381. concerning the treatment of external Sprite and Flat PWADS. It will
  382. enables you to distribute PWADS containing only the Sprites and/or Flats
  383. that you wish to replace. There are some caveats here, so read the
  384. manual! DeuSF can read DMADDS files, but its' preferred PWAD composer is
  385. of course DeuTex, since PWADS composed for DMADDS are very dirty inside.
  386.  
  387. DEUSF Features:
  388.  
  389. -  Recreate a complete Sprite and/or Flat PWAD from a partial Sprite
  390.    and/or Flat PWAD and the main WAD of DOOM.
  391.  
  392. +WARNING: The Sprite names VILE[, VILE\ and VILE] are not valid DOS file
  393. +        names, so DeuTex replaces them with VILE$, VILE@ and VILE# when
  394. +        extracting them to files. Use these names for your files, too. 
  395.  
  396.                                                                   page v
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403. ***************************** WHAT'S NEW? *****************************
  404.  
  405. + New in DeuTex 3.3
  406. +
  407. + -  Added a -get function to retrieve a single WAD entry
  408. +    (sound of picture)
  409. + -  Improvements to -merge so that it can be used with Heretic
  410. +      NOTE: HERETIC V1.0 CAN'T USE EXTERNAL SPRITE WAD.
  411. +      THIS IS A BUG INHERETIC, NOT DEUTEX, DEUSF OR NWT
  412. + -  Sound formats corrected (at least) but compression not supported.
  413. + -  Now -merge and -app, -join preserve the file time, not only the
  414. +    contents so that you can still patch your IWAD after -merge.
  415. + -  A _DEUTEX_ entry is added in the WAD directory, for -merge
  416. +    and -app and -join so that even if you use some pervert tool
  417. +    on your WAD, -restore should be able to restore it provided    
  418. +    your tools don't modify bytes before the directory.
  419. +    This is for ease of use with NWT.
  420. +      NOTE: DON'T USE DMGRAPH ANYMORE. IF YOU WANT TO MERGE ENTRIES
  421. +      INTO A WAD, MAKE A SPECIAL WAD OF THESE ENTRIES AND USE
  422. +      DEUSF -join TO MERGE THAT NEW WAD INTO THE DESIRED WAD
  423. + - New [MUSICS] section and MUSICS subdirectory. Yes, I suddenly had
  424. +   enough of mixing sounds and music. Should have done that before
  425. + - Small patch to prevent DCK from bugging at modified IWADs
  426. +
  427. + - DeuTex can now read duplicate sections in Wadinfo.txt
  428. +   when extracting new data, if wadinfo.txt exist , it appended
  429. +
  430. + - New Visual Basic shell (still under progress.)
  431.  
  432.  
  433.  
  434.           SUPPORTED
  435.  
  436.  
  437.    DOOM  registered                  1.1 to 1.8 and above
  438.    DOOM2                             1.6 to 1.8 and above
  439. +  HERETIC registered                1.0 and (probably) above
  440.  
  441.      NOT SUPPORTED  (by request of IDsoftware)
  442.  
  443.    DOOM shareware              
  444. +  HERETIC shareware
  445.  
  446.    It is possible for a hacker to modify DeuTex/DeuSF and make
  447.    it compatible with DOOM or HERETIC shareware.
  448.    If you're *that* short of money that you're ready to hack a
  449.    prog to save 40$ and the pleasure to be supporting one of the 
  450.    very best game company, please don't distribute your version
  451.    of DeuTex/DeuSF, because I'm have no time to spend answering
  452.    to questions about a hacked DeuTex that could possibly fail
  453.    very differently than the original.
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                                                  page vi
  460.  
  461.  
  462.  
  463.  
  464.                     ----------------------------
  465.                 *** [PART ONE]   GETTING STARTED ***
  466.                     ----------------------------
  467.  
  468.  
  469. CHAPTER 1
  470. ****************************** OVERVIEW *******************************
  471.  
  472. DeuTex is a GREAT program!
  473.  
  474. <editors note>
  475. (preceding claim inserted over the objections of Olivier Montanuy) ;-)
  476.  
  477.  
  478. *********************** A Note About This Manual ***********************
  479.  
  480. There is a lot of redundancy in the manual. This is intentional. The
  481. manual is intended to be used as a reference. When you have a question
  482. on a particular aspect of DeuTex, look up a likely entry in the Table of
  483. Contents, and read that entry. It should have the information you need.
  484. This is to prevent you from having to jump around from page to page to
  485. figure out a procedure in DeuTex. This doesn't mean that sections are
  486. identical. Each section attacks a problem from a different viewpoint.
  487. If one section doesn't help you, maybe a different 'angle' will.
  488.  
  489. ************************************************************************
  490.  
  491. This manual has a lot of trees in it. This chapter will give you a view
  492. of the forest. DeuTex and DeuSF are powerful programs that will let you
  493. do almost anything you can imagine in composing or manipulating PWADS.
  494. Notice the word composing. Deutex is an Orchestra Conductor. It can
  495. perform whatever music you write for it brilliantly, but you must
  496. supply the musicians. A PWAD consists of many parts. DeuTex coordinates
  497. those parts to give you the PWAD you desire, but it doesn't create
  498. them. With DeuTex you have access to all the resources in the DOOM1 or
  499. DOOM2 IWADS. Since it does so many things, it might seem a little
  500. confusing at first glance. Don't worry. If you are familiar with DOOM
  501. (read Matt Fell's DOOM specs and Hank Leukart's DOOMFAQ), then all you
  502. need to learn about DeuTex is it's organization.
  503.  
  504. There are so many resources in DOOM that it isn't reasonable to put them
  505. all in one directory. DeuTex uses a subdirectory for each entry type.
  506. Using these subdirectories is easy once they're explained.
  507.  
  508. Deutex makes it possible to use a simple, straightforward method for
  509. working with custom graphics (and sounds).  The approach is as follows:
  510.  
  511.  1) Put your resource files in subdirectories such as FLATS, SPRITES,
  512.     etc., further discussed below.
  513.  
  514.  2) Use a `Wadinfo' file called something like `goodies.txt' to tell
  515.     Deutex how to assemble the resources into a PWAD.
  516.  
  517.  3) Run `deutex -make goodies.txt goodies.wad' to make the PWAD.
  518.  
  519. Now you can play your level with the resources, without any fuss
  520. (unless, of course, something has gone wrong along the way).
  521.  
  522.  
  523.  
  524.  
  525.                                                                   page 1
  526.  
  527.  
  528.  
  529.  
  530. This method works for any resource. You can make sound-only wads that
  531. will play with any version of DOOM. You can include Level maps in a
  532. multi-level PWAD. DeuTex will put the Levels where you want them,
  533. regardless of the internal ExMy OR MAPxx of the Level. If the finished
  534. PWAD doesn't contain new Sprites or Flats, it can be played as is.
  535. Otherwise, it can be rendered playable with DeuSF, which can be freely
  536. distributed with your PWADS.
  537.  
  538. The DeuTex Visual Basic shell let's you use the Windows environment to
  539. distribute those entries in the right directory, and then execute the
  540. -make command. It doesn't change the way DeuTex works, it only makes
  541. your life easier.
  542.  
  543.                            ---------------
  544. A)                         WHAT IS DEUTEX?
  545.                            ---------------
  546.  
  547. DeuTex is a PWAD compiler. It allows you to organize ALL the resources
  548. you modify, and group them into your PWAD in a single step. This
  549. eliminates the need for running a different program for each type of
  550. editing you want to do (DMAUD, DMGRAPH, DMADDS, etc).
  551.  
  552. DeuTex is NOT a:
  553.                 map editor,          (use DEU, DoomCAD, WadEdit...)
  554.                 nodes builder,       (use DEU, BSP, IDBSP,...)
  555.                 reject map builder   (use RMB or REJECT)
  556.                 DOOM.EXE editor      (use DEHACKED)
  557.  
  558. Your Level map with nodes, reject and blockmap already calculated is
  559. just another resource to DeuTex. If you don't want to redefine or create
  560. Textures, Flats, Sounds, etc. in your PWAD, you don't need DeuTex.
  561.  
  562.        On the other hand, if you redefine LOTS of stuff,
  563.        you'll wonder how you ever got along without it.
  564.  
  565. If you've worked with wads before, you know how many times you have to
  566. go in and change something! With DeuTex, you just edit the resource you
  567. want to change, throw it back in it's subdirectory, and run a batch
  568. file to put everything together again.
  569.  
  570.                             ------------
  571. B)                          INSTALLATION
  572.                             ------------
  573.  
  574. DeuTex comes in zipped format. Naturally, you need a copy of PKUNZIP
  575. (v2.04G) to unzip it. If you don't have one, go get it! It's probably
  576. available the same place you got DeuTex. PKUNZIP also exist for Unix. 
  577.  
  578. The file name is DEUTEX33.ZIP or something like it. This manual is valid
  579. for DeuTex versions 3.3 and above. Some information is not applicable to
  580. previous versions, and may cause you problems. Be forewarned!
  581.  
  582. Installing DeuTex:
  583.  
  584. DeuTex and DeuSF should be put somewhere in your path, e.g. under
  585. C:\DOS in DOS, ~/bin under Linux/Unix, etc. This is not ABSOLUTELY
  586. necessary, as you can put a copy in your working directory each time
  587. or specify path names in all the commands, but, believe me, it makes
  588. life much simpler.
  589.  
  590.  
  591.                                                                   page 2
  592.  
  593.  
  594.  
  595.  
  596. You should enable DeuTex/DeuSF to locate your DOOM or DOOM2 files
  597. by creating an environmental variable DOOMWADDIR that points to
  598. your DOOM path like this: 
  599.  
  600. For DOS, put the line 'SET DOOMWADDIR=C:\GAMES\DOOM' in AUTOEXEC.BAT.
  601.  
  602. For Linux/Unix, use 'setenv DOOMWADDIR ~/games/doom' in .tcshrc.
  603.  
  604. This is more important for the Linux/Unix version, since with DOS
  605. the command DeuTex -doom <doomdir> will achieve the same result. In
  606. DOS, it's possible to get an 'out of environment space' error if you
  607. have too many variables defined in autoexec.bat (including path, etc).
  608. If this occurs, use DOS Help for the SHELL command to find out how to
  609. increase your environment space.
  610.  
  611.        Of course, DeuTex will only work if the REGISTERED
  612.        version DOOM.WAD or DOOM2.WAD is available.
  613.  
  614. Should you be in dire need of disk space, or should you wish to use
  615. DeuTex on a machine that can't run DOOM, you can use DeuTex to build a
  616. fake DOOM.WAD or DOOM2.WAD, keeping only the structure of the directory
  617. and the entries PLAYPAL, TEXTURE1, TEXTURE2 and PNAMES. Of course, to do
  618. this, you first need a complete registered DOOM.WAD or DOOM2.WAD, and
  619. even then it's a real pain. Beware to keep that file for yourself ONLY.
  620.  
  621. The zip file for DeuTex 3.0 contains the following files. For
  622. illustration purposes, the diagram assumes you put DTEX30.ZIP
  623. in the root directory (C:\). Directory information is embedded
  624. in the zip file, so use the PKUNZIP -d option:
  625.  
  626.      PKUNZIP -d DTEX30.ZIP  will produce:
  627.  
  628. C:\dtex30.zip
  629.   |_
  630.     \DEUTEX\  deusf.exe    - DeuSF program.
  631.            |  deutex.exe   - DeuTex program.
  632.            |  deutex.pif   - Windows pif file for VBDeuTex.
  633.            |  dtexman.txt  - This manual.
  634.            |  file_id.diz  - For BBS use.
  635.            |  midi2mus.exe - MIDI to .MUS converter.
  636.            |  readme.txt   - Short descrition of DeuTex/DeuSF.
  637.            |  vbdeutex.exe - Visual Basic Shell for DeuTex.
  638.            |  vbdeutex.txt -  Short description of VBDeuTex.
  639.            |_
  640.        | \PALETTE\ doompal.pal - DOOM, PaintShop Pro format.
  641.            |           doompal.ppm - DOOM, PPMQUANT format.
  642.        |           palette.txt - Short description of the palettes.
  643.        |           heretic.pal - HERETIC, PaintShop Pro format.
  644.        |_
  645.          \TEST-ME\ test-me.txt - Directions for the TRINITY example.
  646.                        trinity.bat - DOS batch file for TRINITY example.
  647.                        trinity.cmd - OS/2 file for TRINITY example.
  648.  
  649. You may end up moving the palettes if you want them in their native
  650. application's directory, but leave DEUTEX\TEST-ME alone. When you do
  651. the demo, you'll want it to be in its own directory.
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                                                   page 3
  658.  
  659.  
  660.  
  661.  
  662.                        ----------------------
  663. C)                     DIRECTORIES AND DeuTex
  664.                        ----------------------
  665.  
  666. Chapter 5 tells you all about the directories DeuTex uses, but this
  667. section will give you the general picture. I'm going to use an
  668. imaginary cakemaking machine to explain DeuTex's directories (I know,
  669. I know, it's stupid! <g>). To make cake with this machine, you put your
  670. flour in one, container, raisins in another, sugar another, milk,
  671. icing, walnuts, chocolate, eggs, etc. All your best stuff, each in it's
  672. own place. Then you flip the switch, and the machine thumps and smokes,
  673. and voila! Cake!
  674.  
  675. DeuTex works in the same way . You put your Map in one box, Sounds in
  676. another, Textures, Patches, Graphics, Lumps, Sprites and Flats all in
  677. their own boxes. If you don't want raisins today, leave the Sprites box
  678. empty. When all is in place, flip the switch (DeuTex -make, in a batch
  679. file preferably), DeuTex thumps and smokes for a little while, and
  680. voila! PWAD!
  681.  
  682.                             ---------------
  683. D)                          WHAT DO I NEED?
  684.                             ---------------
  685.  
  686. ************************** User Requirements *************************
  687.  
  688. ATTENTION: DeuTex is not completely trivial to use. It requires a
  689.            fully functional processing unit, with a least 10000 meg
  690.            of available neurons, some basic DOS and DOOM specs dynamic
  691.            libraries and at least 1 or 2 hours of spare processing
  692.            time at a minimum 80% attention rate. You have been warned.
  693.  
  694. SUGGESTION: If you use DeuTex, try New Wad Tool, too. The two tools
  695.             combine very well together under DOS. (NWT is not available
  696.             for other O/S).
  697.  
  698. ************************ Hardware Requirements ***********************
  699.  
  700. This program is an ordinary DOS executable, compiled in a HUGE memory
  701. model, with 386 instructions. It does not make use of a math copro-
  702. cessor. It should run with about 500k of free base memory, or less. It
  703. might not run under a 286. It was tested on a Compaq LITE 4/33c and an
  704. IBM Thinkpad 755c.
  705.  
  706. Unix, Linux, OS/2, SGiX and Alpha versions are also available. 
  707.  
  708.                            -------------
  709. E)                         WHAT DO I DO?
  710.                            -------------
  711.  
  712. Please read this Manual before asking questions. I know it's boring, but
  713. this IS freeware, and I have limited time to support it. Bug reports ARE
  714. appreciated IF they come with the files you were using when the bug
  715. occurred, and a full description of it.
  716.  
  717. Read and be familiar with all the DOOM literature you can, especially
  718. the 'unofficial' DOOM SPECS 1.6 by Matt Fell. You don't need to read the
  719. file formats, but you need to understand what the different entries are
  720. for, and the tricks and limitations of DOOM.
  721.  
  722.  
  723.                                                                   page 4
  724.  
  725.  
  726.  
  727.  
  728. DeuTex makes some checks on your PWAD, but I don't have time to program
  729. for all possible errors.  Become familiar with the various editors you
  730. need to create the resources used in this program. DeuTex does not edit
  731. things. It puts the things YOU edit together. For editing, use the best
  732. Sound or Graphic editor you can afford.
  733.  
  734. When the foregoing is done, you take all your cool stuff. You put it in
  735. DeuTex's boxes. You give DeuTex the directions on what to DO with your
  736. stuff. You run DeuTex. That's All, Folks.
  737.  
  738.  
  739.  
  740.  
  741.                          ------------------
  742. F)                       WHAT IS DEUSF FOR?
  743.                          ------------------
  744.  
  745.  
  746. DeuSF is a program to help overcome some of DOOM's limitations,
  747. and still be able to distribute a reasonable sized PWAD. With
  748. Sprites and Flats, you have to replace EVERYTHING in order for
  749. DOOM to work right. This makes for a big PWAD (3 to 5 megs), and
  750. it's illegal to take iD's Sprites or Flats from DOOM, put them in
  751. your PWAD, and then distribute them.
  752.  
  753. DeuSF allows you to replace as few Sprites and Flats as you desire,
  754. and distribute ONLY THOSE with your PWAD. With the appropriate batch
  755. file, it will change things at the USER's site to enable your PWAD to
  756. play, without stepping on toes, or asking people to download multi-
  757. megabyte single Level PWADS!
  758.  
  759. Another advantage of DeuSF is that it makes Sprite PWADs playable with
  760. either DOOM or DOOM2 using the same install.bat file. Isn't that great?
  761.  
  762.  
  763.  
  764.  
  765.                      --------------------------
  766. G)                   WHAT ARE THE PALETTES FOR?
  767.                      -------------------------- 
  768.  
  769.  
  770. doompal.pal  (JASC palette, for Paintshop PRO shareware program)
  771. doompal.ppm  (Portable Pix Map, for PBMPLUS freeware package)
  772.  
  773. These are the color palettes used by DOOM.
  774.  
  775. If you edit or create any graphics (Patches, Sprites, etc.) in your
  776. favorite graphics program, the colors will most likely be different
  777. from the ones used in DOOM. When they are inserted in a PWAD, they
  778. need to be 'quantized', which is a fancy word for color-matched.
  779. Although this sounds simple, it can actually be quite involved. DeuTex
  780. can quantize colors, but it's not optimised for that, so quantization
  781. might be slow and quite poor.
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                                                   page 5
  790.  
  791.  
  792.  
  793.  
  794. What should you do before inserting a picture with DeuTex?
  795.  
  796. * AVOID regular patterns, like squares/stripes. These patterns are prone
  797.   to create ugly aliasing when scaled by DOOM.
  798. * SMOOTH it! I mean, apply a low pass filter so that it appears blurred.
  799.   This will also hide some of the aliasing effects of scaling.
  800. * QUANTIZE your colors with one of the supplied DOOM palettes. DeuTex is
  801.   optimised for the original DOOM palette. If you use another palette,
  802.   it will be slower. DeuTex will quantize your colors to the DOOM colors
  803.   using a strange alchemy. No dithering.
  804. * TRANSPARENT areas should be made of A UNIQUE COLOR, preferably CYAN
  805.   (r=0,g=255,b=255, but you can specify another color to DeuTex.)
  806.  
  807.   WARNING: Some lame programs don't support full 0-255 range. CYAN could
  808.            be r=0, g=252, b=252. Experiment first.  
  809.  
  810. The enclosed palettes are in the format of two good graphics programs.
  811. Use them to quantize your pictures before you feed them to DeuTex.
  812.     
  813. doompal.pal is in the format used by PAINTSHOP PRO v2, a popular
  814. shareware graphics program with excellent color conversion capabilities.
  815.  
  816. To convert with doompal.pal in PAINT SHOP PRO:
  817.  
  818.  -  Load the file you want to convert.
  819.  -  Select *Colors* from the menu bar.
  820.  -  Select *Load Palette* from the drop-down menu.
  821.  -  Browse to find doompal.pal and select it.
  822.  -  In the 'apply palette to image using' box, select *error diffusion*.
  823.  -  Select *OK*.
  824.  
  825. PaintShop Pro will then quantize your image to the DOOM palette.
  826.  
  827.  -  Select *File* from the menu bar.
  828.  -  Select *Save As* from the drop-down menu.
  829.  -  Select *BMP - OS/2 or Windows Bitmap* from 'List files of type'.
  830.  -  Select *Windows RGB Encoded* from 'File Sub-format'.
  831.  -  Select *OK*.
  832.  
  833. DOOM will now display your Graphic pretty much as you expect.
  834.  
  835. If you want to make a .PBM (portable bitmap), use ppmquant on your
  836. picture, with doompal.ppm as the reference for colors.
  837.  
  838. + Alternatively, if you extract a DOOM Graphic with DeuTex, it will
  839. + contain the DOOM palette. You can then feed it to your favorite
  840. + program, and let it extract the palette for later reuse.
  841. +
  842. + WARNING: 
  843. + Experiment with this first, as your program might not do what you
  844. + expect it to. For example ZSoft's PC Paintbrush will load the DOOM
  845. + Graphic correctly and allow you to save the palette. However, if you
  846. + take a 24 bit image and load the palette, nothing will happen. You can
  847. + let PC Paintbrush convert the image to 256 colors (which it will do
  848. + poorly), and then apply the palette. The results will be grotesque,
  849. + because it doesn't quantize when applying a palette. A DOOM palette
  850. + saved in this program would be useful only for Graphics you want to
  851. + hand-draw from scratch. The moral is, if you don't know what you're
  852. + doing, experiment first before using a Graphic you don't want to lose.
  853.  
  854.  
  855.                                                                   page 6
  856.  
  857.  
  858.  
  859.  
  860. CHAPTER 2
  861. *************** TEST-ME or What's inside TRINITY.WAD? *****************
  862.  
  863.                              -------------
  864. A)                           About TEST-ME
  865.                              -------------
  866.  
  867.     TRINITY.BAT let's you have a quick overview of some of the cap- 
  868.     abilities of DeuTex so you can decide if it's worth the trouble.
  869.  
  870. TRINITY.BAT does the following:
  871.  
  872.     It lists the contents of TRINITY.WAD (with identifications).
  873.     It decomposes TRINITY.WAD and builds TRINIDAD.WAD.
  874.     All this in only 3 trivial DeuTex commands.
  875.  
  876. Requirements:
  877.  
  878. -  You must have TRINITY.WAD, the great PWAD by Steve McCrea.
  879.    (available on infant2.sphs.edu as TRINITY2.ZIP and
  880.    in the Compuserve GAMERS FORUM LIB 8 as TRINTY.ZIP)
  881. -  Doom must be in the \DOOM directory (\DOOM2 could work too)
  882. -  TRINITY.WAD must be in the current directory.
  883. -  You must have *some* room left on your disk :-)
  884. -  You must be running DOS 5.0 or higher.
  885. -  You must NOT reuse any part TRINITY.WAD without crediting Steve.
  886.  
  887. Description of the file, TRINITY.BAT:
  888.  
  889.                         ----------------------
  890. B)                      Listing the directory
  891.                         ----------------------
  892.  
  893.       rem     ***DeuTex***
  894.       deutex  -doom \doom     -wadir TRINITY.WAD
  895.               ^^^^^^^^^^^^    ^^^^^^^^^^^^^^^^^^
  896.                   (a)                (b)
  897.  
  898. (a)---> This tells DeuTex that DOOM.WAD and DOOM.EXE are in the
  899.         \DOOM directory. OPTIONAL.
  900. (b)---> This tells DeuTex to list the directory of TRINITY.WAD
  901.         reporting the entry types. Types *could* be wrong, but not
  902.         with Trinity.
  903.  
  904.                         ------------------------
  905. C)                      Decomposing TRINITY.WAD:
  906.                         ------------------------
  907.  
  908.       rem     ***DeuTex***
  909.       deutex  -doom \DOOM    -dir .    -xtract TRINITY.WAD
  910.               ^^^^^^^^^^^    ^^^^^^    ^^^^^^^^^^^^^^^^^^^^^^
  911.                   (a)         (b)               (c)
  912.  
  913. (a)---> The same as before.
  914. (b)---> This tells DeuTex that it must store the result in '.' (which is
  915.         the current directory).  You could skip (b), since '.' is the
  916.         default, or you could specify another directory, like -dir TEST.
  917. (c)---> This tells DeuTex to extract all entries from TRINITY.WAD.
  918.  
  919.  
  920.  
  921.                                                                   page 7
  922.  
  923.  
  924.  
  925.  
  926.                 ----------------------------------------
  927. D)              Recomposing TRINITY.WAD as TRINIDAD.WAD:
  928.                 ----------------------------------------
  929.  
  930.       rem    ***DeuTex****
  931.       deutex  -doom \doom   -dir .   -make WADINFO.TXT TRINIDAD.WAD
  932.               ^^^^^^^^^^^   ^^^^^^   ^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^
  933.                   (a)        (b)            (c)            (d)
  934.  
  935. (a)--->  The same as before.
  936. (b)--->  The same as before.
  937. (c)--->  This tells DeuTex to create a new PWAD, from the
  938.          creation directives contained in WADINFO.TXT.
  939. (d)--->  This is the name of the created PWAD.
  940.  
  941.  
  942.                         ------------------------
  943.  E)                     Customizing TRINITY.WAD:
  944.                         ------------------------
  945.  
  946.     You can edit WADINFO.TXT, the format is pretty simple to guess.
  947.    (see Chapter 8 - FORMATS for a precise definition.)
  948.  
  949. -  A line that begins with a ';' or '#' is a comment. DeuTex ignores it.
  950. -  Don't touch any lines with [xxxx] (they are section delimiters).
  951.  
  952. + Lets look at the [MUSICS] section:
  953.  
  954. +   [MUSICS]
  955.     D_E1M1
  956.  
  957. +   This tells DeuTex to go into the \MUSICS subdirectory and get a file
  958.     called D_E1M1.MUS, which is the music of TRINITY.WAD. You might
  959.     wish to delete this D_E1M1 if your soundcard crashes while playing
  960.     trinity.
  961.  
  962.     You can add your own music, for Episode 1 Mission 2 by editing:
  963.  
  964. +    [MUSICS]
  965.     D_E1M1
  966.     D_E1M2
  967.  
  968.     Of course, the file D_E1M2.MUS must exist... You can generate it
  969.     from D_E1M2.MID (MIDI format) by using MIDI2MUS.
  970.  
  971.  
  972.  
  973. BEWARE: DeuTex is NOT fool proof yet. It should not crash your
  974.         computer, but the generated PWAD may crash DOOM if you make
  975.         mistakes. I'm very sorry for this, but I have more urgent
  976.         optimizations to do than foolproofing. However, the PWAD
  977.         generated here should not crash DOOM, if you use the real
  978.         TRINITY.WAD as a basis.
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                                                   page 8
  988.  
  989.  
  990.  
  991.  
  992. CHAPTER 3
  993. ************************** WORKING WITH WADS **************************
  994.  
  995.                               ------------
  996. A)                            INTRODUCTION
  997.                               ------------
  998.  
  999. Read the DOOM SPECS:
  1000. Sorry. This is still unavoidable, because of the various tricks and
  1001. limits of DOOM. If you have a problem, there is a VERY GOOD chance
  1002. it's referred to somewhere in Matt Fell's SPECS.
  1003.  
  1004. NOTE: In the following discussion, avoid these common mistakes:
  1005.  
  1006. Hall of Mirrors with new Textures:
  1007.  
  1008.          First, create your Level.
  1009.          Then, build the nodes and reject.
  1010.          Then add the new Textures.
  1011.  
  1012. Why? We don't know.  leonardc@halcyon.com reported he saw a hall of
  1013. mirrors with old versions of DeuTex that didn't first load the old DOOM
  1014. Textures. It seems to be a problem with the node builders.
  1015.  
  1016. Tutti Frutti and Medusa Effect:
  1017.  
  1018. See the DOOM specs, and Chapter 8 - FORMATS.
  1019. If DOOM attempts to display part of a Texture not covered by a Patch,
  1020. you'll see some ugly garbage (usually has pinks and greens, thus 'Tutti
  1021. Frutti'). The same thing happens if you use more than one Patch on a
  1022. Texture with transparent areas, or walls with see-thru portions on upper
  1023. or lower Textures. If the area is big enough, it will slow the display
  1024. to a crawl ('Medusa Effect' - Looks like snakes and turns you to stone).
  1025.  
  1026. Doom reports a void column and exits:
  1027.  
  1028. One of your Textures has a column with no Patches. Use DeuTex -check on
  1029. a PWAD before running DOOM. It reports Textures that have void columns.
  1030.     
  1031.  Other bugs:
  1032.  
  1033.    Mail me a description of the bug, together with any configuration
  1034.    files. Don't expect a quick answer, though.
  1035.  
  1036.                         -----------------------
  1037. B)                      How to decompose a PWAD
  1038.                         -----------------------
  1039.  
  1040. First check that all the entries are identified correctly:
  1041.  
  1042.   DEUTEX -wadir NEWBIE.WAD    This will list the directory.
  1043.  
  1044. Then try:
  1045.  
  1046.   DEUTEX -unused NEWBIE.WAD   This will tell you if there is any wasted
  1047.                               data in the PWAD. It's always funny to see
  1048.                               how DMGRAPH and DMAUD waste *some* data.
  1049.                               This won't tell you about any data wasted
  1050.                               by incorrect entry formats, though.
  1051.  
  1052.  
  1053.                                                                   page 9
  1054.  
  1055.  
  1056.  
  1057.  
  1058. To extract all the entries:
  1059.  
  1060.    DEUTEX -xtract NEWBIE.WAD  The whole directory structure is extracted
  1061.                               to subdirectories. WADINFO.TXT is created
  1062.                               in the working directory. TEXTURE1.TXT is
  1063.                               created in the \TEXTURES subdirectory.
  1064.  
  1065.  
  1066. To extract only a part of the directory; Sounds, for instance:
  1067.  
  1068. DEUTEX -sound -xtract NEWBIE.WAD   Only the Sounds are extracted and
  1069.                                    placed in the \SOUNDS subdirectory,
  1070.                                    which is created if it doesn't exist.
  1071.  
  1072. NOTE: Some PWAD creators declare Patches, Flats and Sprites outside of
  1073.       the normal boundaries. In that case, DeuTex may not identify them
  1074.       correctly. They'll end up in either the \LUMPS subdirectory in raw
  1075.       (.LMP) format, or the \GRAPHICS subdirectory (.BMP). Care has been
  1076.       taken to handle the most common situations, and this almost never
  1077.       happens in fact, but there is no general solution. You may have to
  1078.       check that all entries have been properly identified.
  1079.  
  1080. Once you have decomposed a PWAD, you can rebuild it with:
  1081.  
  1082. DEUTEX -make WADINFO.TXT NEWBIE.WAD
  1083.  
  1084. WADINFO.TXT already exists, because it was automatically created during
  1085. the extraction of NEWBIE.WAD (cool, no?). Make sure you delete or move
  1086. the previous version of NEWBIE.WAD before you remake it, because DeuTex
  1087. will not overwrite your files (you might not like it :-]).
  1088.  
  1089. NOTE: DEUTEX puts a signature in the first few bytes of a created PWAD,
  1090.       to identify which version of DEUTEX was used.
  1091.  
  1092.                  --------------------------------------
  1093. C)               How to create a PWAD with new Textures
  1094.                  --------------------------------------
  1095.  
  1096.  First list DOOM's Textures, as a reference:
  1097.  
  1098.  DEUTEX -dmtexture
  1099.  
  1100.  This will extract all the Textures from the main IWAD. They will be
  1101.  written to OLDTEX1.TXT (and OLDTEX2.TXT for DOOM1 only). These text
  1102.  files will be placed in the subdirectory \TEXTURES, which will be
  1103.  created if it doesn't exist. These files make it easy for you to
  1104.  redefine existing Textures by cutting them out and pasting them into
  1105.  YOUR Texture definition file. For DeuTex 3.1 and above, they serve no
  1106.  other purpose. You can delete what's left of them when you're
  1107.  finished.
  1108.  
  1109.  To create a new Texture, define it in a Texture file you create (e.g.
  1110.  TEXTURE1.TXT). TEXTUR1.TXT can have any name but TEXTURE1.TXT is
  1111.  prefered. You can use as many Texture files as you like, as long
  1112.  as they're declared in WADINFO.TXT. Place your file(s) in the
  1113.  \TEXTURES subdirectory. To redefine an existing Texture, just cut the
  1114.  desired Texture out of OLDTEX1.TXT or OLDTEX2.TXT (DOOM1 only).
  1115.  Paste them into TEXTURE1.TXT. Then edit them as you please. You can
  1116.  delete OLDTEX1.TXT and OLDTEX2.TXT when you're finished.
  1117.  
  1118.  
  1119.                                                                  page 10
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  NOTE: For DOOM1/HERETIC only, use one file for redefined Textures
  1125.        from OLDTEX1.TXT, and another file for redefined Textures 
  1126.        from OLDTEX2.TXT. In DeuTex v3.3, WADINFO.TXT uses a second
  1127.        Texture section called [TEXTURE2] for redefined OLDTEX2 files. 
  1128.  
  1129.  
  1130.  DeuTex 3.3 doesn't care if OLDTEX1.TXT or OLDTEX2.TXT exist.
  1131.  DeuTex 2.x used to require that all the old textures be present,
  1132.  but now DeuTex 3.3 first read the internal DOOM texture definitions,
  1133.  then reads the file you tell it to read, for new definitions.
  1134.  If you mistakenly define the same Texture in multiple files,
  1135.  only the last declared version will be used. Of course, that means
  1136.  that if you redefine a DOOM texture your version will be used.
  1137.  
  1138. Declare TEXTURE1 in the [TEXTURE1] section of WADINFO.TXT.
  1139. Then build your PWAD:
  1140.  
  1141. DEUTEX -make WADINFO.TXT NEWBIE.WAD
  1142.  
  1143. At this point, it would be a good idea to
  1144. check your new PWAD for Texture errors:
  1145.  
  1146. DEUTEX -check NEWBIE.WAD
  1147.  
  1148.  
  1149.             -----------------------------------------------
  1150. D)          How to create a PWAD with new Sprites and Flats
  1151.             -----------------------------------------------
  1152.  
  1153. ******** 1) Sprite and Flat REPLACEMENT
  1154.  
  1155. BEWARE: Sprite replacement is tricky. If some needed sprites are
  1156.   missing DOOM will lock up. Check your work often.
  1157.  
  1158. Put your Sprite files in \SPRITES in .GIF or .BMP format.
  1159. Put your Flat files in \FLATS in .GIF or .BMP format.
  1160. Declare your Sprite NAMES in the [SPRITES] section of WADINFO.TXT.
  1161. Declare your Flat NAMES in the [FLATS] section of WADINFO.TXT.
  1162. Use only the NAME in WADINFO.TXT, without the .GIF or .BMP extension.
  1163.  
  1164.  Since DeuTex 3.1:
  1165.  The '=' label lets your Sprites keep the names YOU have given
  1166.  them. It tells WADINFO.TXT what DOOM Sprite you mean to replace.
  1167.  This enables you to name your sprite files as you damn wish.
  1168.  
  1169.  
  1170. If you want to replace *ALL* of the Sprites and Flats in DOOM (crazy):
  1171.  
  1172. DEUTEX -iwad -make WADINFO.TXT NEWBIE.WAD
  1173.  
  1174. NEWBIE.WAD will be directly usable by DOOM.
  1175.  
  1176.  
  1177. Remember: replacing only part of the Sprites and Flats mean you'll
  1178. need DeuSF to install your PWAD, but it will be compatible with ALL
  1179. versions of DOOM and DOOM2. Redefining all the Sprites is not a good
  1180. idea unless you really mean it.
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                                                  page 11
  1186.  
  1187.  
  1188.  
  1189.  
  1190. To replace *SOME* of the Sprites and/or Flats in DOOM (better):
  1191.  
  1192. DEUTEX -make WADINFO.TXT NEWBIE.WAD
  1193.  
  1194. This NEWBIE.WAD will be much smaller and easier to distribute.
  1195. BUT: This NEWBIE.WAD will cause DOOM to lock up when it starts!(bad)
  1196.  
  1197.     So, if you want to replace only *SOME* of the Sprites and Flats in
  1198.     DOOM, you have 3 choices:
  1199.  
  1200. DEUTEX -merge NEWBIE.WAD           Modifies DOOM.WAD or DOOM2.WAD.
  1201.                                   (Safe, fast, and small)
  1202.  
  1203. DEUSF  -append NEWBIE.WAD          Modifies NEWBIE.WAD.
  1204.                                   (Safer, still fast, wastes some space)
  1205.  
  1206. DEUSF -add NEWBIE.WAD NEWBIE2.WAD  Creates NEWBIE2.WAD.
  1207.                                   (Safest, not slow, more space wasted)
  1208. +
  1209. + NEW! To merge two PWADS that both redefine Sprites and/or Flats:
  1210. +
  1211. + DEUSF -join FIRST.WAD SECOND.WAD  (FIRST.WAD now contains both wads)
  1212.  
  1213.  
  1214. NOTE: The steps above are performed at the end users' site, preferably
  1215.       from a batch file supplied with your PWAD. This means the user
  1216.       must have DeuSF, which can be distributed freely with your PWAD,
  1217.       or DeuTex, which has some restrictions on distribution. See the
  1218.       License Agreement at the end of this manual for the restrictions
  1219.       on distributing DeuTex.
  1220.  
  1221. The -sprite command is used to add only Sprites, ignoring the Flats:
  1222.  
  1223. DEUSF -sprite -app NEWBIE.WAD
  1224.  
  1225. The -flat command is used to add only Flats, without the Sprites:
  1226.  
  1227. DEUSF -flat -add NEWBIE.WAD NEWBIE2.WAD
  1228.  
  1229.  
  1230. + ******** 2) HOW to ADD or REMOVE SPRITE VIEWPOINTS
  1231. +
  1232. + DeuTex allows you to alter the number of viewpoints a Sprite displays
  1233. + in your PWAD. DOOM.EXE predetermines the 'behavior' of a given sprite
  1234. + name, but it doesn't predetermine the number of viewpoints. A sprite
  1235. + MUST, however, always have either ONE viewpoint or EIGHT viewpoints.
  1236. + Viewpoints are numbered as follows:
  1237. +
  1238. +                                Front
  1239. +
  1240. +                                  1
  1241. +                            2     |     8
  1242. +                             \____|____/
  1243. +                             |         |
  1244. +                        3 -- | SPRITE  | -- 7
  1245. +                             |_________|
  1246. +                            /     |    \
  1247. +                           4      |     6
  1248. +                                  5
  1249.  
  1250.  
  1251.                                                                  page 12
  1252.  
  1253.  
  1254.  
  1255.  
  1256. + The FULL NAME of the Sprite determines the viewpoint of that Sprite:
  1257. +
  1258. +                             BAR1A2.bmp
  1259. +                             \  /| \________________
  1260. +                              \/ |                  \
  1261. +              ________________/  |  The last number is the viewpoint. A
  1262. +             /                   |  zero here means the Sprite has only
  1263. + The first four letters are the  |  one viewpoint. If not zero, there
  1264. + Sprite Name as recognized by    |  MUST be 8 files for each 'frame' of  
  1265. + DOOM.EXE. They are the same for |  the Sprite.
  1266. + all entries of a given Sprite.  |
  1267. +                                 |
  1268. +          This is the 'frame' number of the Sprite. Animated
  1269. +          Sprites will have consecutive letters here for each
  1270. +          frame (A is frame one, B is frame two, etc.). DOOM.EXE
  1271. +          predetermines how many frames a Sprite uses, so you can
  1272. +          not animate an electrical column, for instance.
  1273. +
  1274. + Sometimes, you will see a Sprite entry that has 2 viewpoints in one
  1275. + Sprite, like BOSSA2A8. This means that the same Graphic is used for
  1276. + viewpoints A2 and A8 (front-left and front-right). When DOOM sees
  1277. + this, it uses the Graphic as is for A2, and mirrors it for A8.
  1278. +
  1279. + In the above example BAR1 is the Barrel Sprite. DOOM does a 2 frame
  1280. + animation on barrels (the slime flickers), so the whole entry is:
  1281. +
  1282. +      BAR1A0
  1283. +      BAR1B0
  1284. +  
  1285. + This disregards the explosion (BEXP) Sprite
  1286. + that is used when you shoot a Barrel.
  1287. +
  1288. + If you want to change the Barrel Sprite to an 8 viewpoint
  1289. + Sprite, you will need to create 16 Graphics:
  1290. +
  1291. +       BAR1A1
  1292. +       BAR1B1
  1293. +       BAR1A2
  1294. +       BAR1B2
  1295. +       BAR1A3
  1296. +       BAR1B3
  1297. +       BAR1A4
  1298. +       BAR1B4
  1299. +       BAR1A5
  1300. +       BAR1B5
  1301. +       BAR1A6
  1302. +       BAR1B6
  1303. +       BAR1A7
  1304. +       BAR1B7
  1305. +       BAR1A8
  1306. +       BAR1B8
  1307. +
  1308. + This gives you 8 viewpoints for EACH frame of the animation. If you
  1309. + only replaced BAR1A1 thru 8, you would see your new Graphic flash to a
  1310. + barrel a couple of times a second, because you didn't replace the 2nd
  1311. + frame. If you add a 3rd frame (BAR1C1 etc.), it will be ignored by
  1312. + DOOM because DOOM.EXE already knows a barrel has only 2 frames.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                                                  page 13
  1318.  
  1319.  
  1320.  
  1321.  
  1322. + Alternatively, you could take an Imp and give it only 1 viewpoint by
  1323. + taking only one of the views for each animation frame and naming it
  1324. + TROOA0.bmp (with the correct letter for the frame you're using). The
  1325. + Sprite will look kind of funny moving around, since it will only face
  1326. + one direction the whole time.
  1327.  
  1328.  
  1329.  
  1330.  
  1331.                   ----------------------------------
  1332.  E)               How to create PWAD with new Sounds
  1333.                   ----------------------------------
  1334.  
  1335. First put your Sound files in the .\SOUNDS directory.
  1336. Then, declare the Sound NAMES in the [SOUNDS] section of WADINFO.TXT.
  1337. See APPENDIX IV for a listing of the Sound names recognized by DOOM.
  1338. Then build your PWAD:
  1339.  
  1340. DEUTEX -make WADINFO.TXT NEWBIE.WAD
  1341.  
  1342. Easy enough?
  1343.  
  1344. Sound effects: [DSxxxxxx.WAV or DSxxxxxx.AU]
  1345.  
  1346. Must be in WAV or AUDIO format (SUN). Make sure the format is *not*
  1347. compressed and does *not* contain comments. My code is pretty basic,
  1348. because I never had the specs of those formats. All is hacked.
  1349.  
  1350. PC speaker Sounds: [DPxxxxxx.TXT]
  1351.  
  1352. Text files containing a list of numbers from 1-255.
  1353.  
  1354. Music: [D_xxxxxx.MUS]
  1355.  
  1356. Must be in MUS format. Convert MIDI files to MUS files by using
  1357. the enclosed MIDI2MUS.EXE (thanks to -dtt-> of ID software).
  1358.  
  1359.  
  1360.  
  1361.  Since DeuTex 3.1:
  1362.  The '=' label lets your Sounds keep the names YOU have
  1363.  given them. It tells WADINFO.TXT what DOOM Sound you
  1364.  mean to replace. This will make your life easier.
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.                                                                  page 14
  1384.  
  1385.  
  1386.  
  1387.  
  1388. CHAPTER 4
  1389. ************************** Visual Basic Shell **************************
  1390.  
  1391.                  -------------------------------------
  1392.                               Vbdeutex.exe
  1393.                  This is the windows shell for DeuTex.
  1394.                         1.3 Alpha test version.
  1395.                  -------------------------------------
  1396.  
  1397. This is an attempt to provide a cool interface for DeuTex.
  1398. However, Visual Basic is slow, and Windows is very difficult to program
  1399. (not really complex, but real bug ridden) so don't expect miracles.
  1400.  
  1401. A file vbdeutex.ini contains parameter for VbDeuTex. This file will
  1402. appear in your windows directory. It defines which level editor, node
  1403. builder, reject builder, Bitmap editor, Text editor you want to use.
  1404. You need VBRUN300.DLL in your windows/system directory, of course.
  1405. All external programs, and deutex among them, shall have a .pif file
  1406. defined. deutex.pif shall call your own version of deutex, exit once
  1407. finished, run in background, as a minimised windows.
  1408.  
  1409. Due to a problem with MS windows programming, I'm unable to create a
  1410. WAD entry browser. To understand why a FAR pointer points at random
  1411. places in memory is beyond my intellectual capacities.
  1412. So Texture composition is a real pain: you must first extract all
  1413. the patches in DOOM together with the OLDTEX1 and OLDTEX2 entries
  1414. (Use command buttons "old textures" and "old patches")
  1415.  
  1416. There is no manual to VbDeuTex. No time to write one, as the product is
  1417. constantly under change. You shall be clever enough to guess what it does.
  1418.  
  1419. The main window is the only one that calls deutex.
  1420. The other windows are edition windows, and call external utilities.
  1421. All you can do with VbDeuTex, you can do with DeuTex, only the presentation
  1422. is a little better.
  1423.  
  1424. When extracting and composing PWADs, you can select which entry types are
  1425. concerned by using the check boxes in front of each entry type.
  1426. For instance, to extract only levels, check the "levels" check box, and               
  1427. don't check the others.
  1428.  
  1429. As a security, you can affect the DOOM and DeuTex DATA directories only
  1430. if the corresponding locks are unckecked (and then, the corresponding
  1431. directory becomes red, as a warning).
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                                                 page 15
  1450.  
  1451.  
  1452.  
  1453.  
  1454.                     -----------------------------
  1455.                 *** [PART TWO]   DETAILS, DETAILS ***
  1456.                     -----------------------------
  1457.  
  1458.  
  1459. CHAPTER 5
  1460. ************************* DIRECTORY STRUCTURE *************************
  1461.  
  1462. DeuTex uses the following directory structure to store DOOM entries.
  1463. First create a directory (call it MYWADIR or whatever) for your PWAD.
  1464. Make sure DeuTex is on your path, or put a copy of it in MYWADIR. Put
  1465. a copy of the PWAD you are working on (MYWAD.WAD) in MYWADIR.
  1466.  
  1467. Type:        DeuTex -xtract mywad.wad
  1468.  
  1469. DeuTex will automatically create the appropriate subdirectories and put
  1470. all the WAD's entries in the proper place. It will also create a file
  1471. named WADINFO.TXT in MYWADIR. If your PWAD is a bare map Level with no
  1472. additions yet, you should get something like:
  1473.  
  1474.             \MYWADIR\--------mywad.wad
  1475.                     |        wadinfo.txt
  1476.                     |        DeuTex.exe (optional, if not on your path)
  1477.                     |_
  1478.                       \LEVELS\------ExMx.wad
  1479.  
  1480. Note that DeuTex will not OVERWRITE any existing files. In the example
  1481. above, if you type DeuTex -xtract AGAIN, you will get an error message
  1482. telling you the files already exist. You have to delete wadinfo.txt and
  1483. ExMx.wad (or move them somewhere else) for xtract to work again. If you
  1484. lose something you wanted to keep, don't blame DeuTex, it's innocent!
  1485.  
  1486.  Now type :   DeuTex <-doom doom directory> -dmtextures
  1487.  
  1488. DeuTex will read the Textures from DOOM.WAD or DOOM2.WAD, list them in
  1489. a file called OLDTEX1.TXT (and OLDTEX2.TXT for DOOM 1) and store them
  1490. in a directory called \TEXTURES, which it will create if it doesn't
  1491. exist.
  1492.  
  1493. NOTE: The <-doom doom directory> command is optional. Take a look at
  1494.       Chapter 6 - DEUTEX COMMANDS for a more complete description of
  1495.       when you should use it.
  1496.  
  1497. Your working directory should now look like this:
  1498.  
  1499.               \MYWADIR\-----mywad.wad
  1500.                       |     wadinfo.txt
  1501.                       |     DeuTex (optional)
  1502.                       |_
  1503.                       | \LEVELS\----ExMx.wad
  1504.                       |_
  1505.                         \TEXTURES\---oldtex1.txt
  1506.                                      oldtex2.txt
  1507.  
  1508.  
  1509. If your PWAD had any other resources (Sprites, Flats, Sounds, etc.) in
  1510. it and you used DeuTex -xtract, it would extract those resources, too.
  1511. Then it would create the proper directory and store them in it.
  1512.  
  1513.  
  1514.  
  1515.                                                                  page 16
  1516.  
  1517.  
  1518.  
  1519.  
  1520. If you want to add something to your PWAD, put it in the proper
  1521. subdirectory (create it if it's not there), and tell wadinfo.txt about
  1522. it. Chapter 8 - FORMATS describes wadinfo.txt in detail.
  1523.  
  1524. Then type: DeuTex -make wadinfo.txt mywad.wad
  1525.  
  1526. DeuTex will read wadinfo.txt and go get all the resources it asks for
  1527. from the directories. Then it will create mywad.wad from them. Note
  1528. that if you create a PWAD from the above example, it  won't be any
  1529. different than what you started out with! You need to put some
  1530. ingredients into the mix before you see any results. THAT's what the
  1531. other directories are for.
  1532.  
  1533. Again note that DeuTex won't overwrite mywad.wad if it exists. Since
  1534. most of the stuff you'll do with DeuTex will be from a batch file, have
  1535. it handle your housekeeping whatever way you like. Something like the
  1536. following works pretty well:
  1537.  
  1538.         del mywad.wad
  1539.         DeuTex -make wadinfo.txt mywad.wad
  1540.         copy C:\DOOM\WADS\mywad.wad mywad.bak
  1541.         copy mywad.wad C:\DOOM\WADS\mywad.wad
  1542.  
  1543. This way, if you find out you've really screwed things up when you test
  1544. your PWAD, there's always a copy of the previous version to use.
  1545.     
  1546. DEUTEX SUBDIRECTORIES:
  1547.  
  1548.                               --------
  1549. A)                             \LEVELS
  1550.                               --------
  1551.  
  1552. 'Bare' PWADS go here! A bare PWAD is one that you have edited and
  1553. constructed the nodes, reject, and blockmap. The PWAD will then
  1554. contain only the following 11 entries in IT'S directory: ExMx(MAPxx),
  1555. THINGS, LINEDEFS, SIDEDEFS, VERTEXES, SEGS, SSECTORS, NODES, SECTORS,
  1556. REJECT, and BLOCKMAP.
  1557.  
  1558. BEWARE: BLOCKMAP REJECT SSECTOR SEGS are not optional! they must have
  1559.         been generated by your Level editor (along with BSP, IDBSP,
  1560.         REJECT, RMB, whatever).
  1561.  
  1562.  THE FILES PUT HERE MUST BE DECLARED IN THE [LEVELS] SECTION OF
  1563.  WADINFO.TXT. ALL FILES MUST BE IN THE FORM ExMx.WAD OR MAPxx.WAD OR
  1564.  EQUATED TO ExMx or MAPxx in WADINFO.TXT.
  1565.  
  1566.  Suppose you have edited two Levels named PLAGUE.WAD and E3M4.WAD. You
  1567.  want the combined PWAD to replace E1M2 and E3M4 in DOOM.WAD. You would
  1568.  edit the [LEVELS] section of WADINFO.TXT to read:
  1569.  
  1570.  [LEVELS]
  1571.  E1M2 =PLAGUE
  1572.  E3M4
  1573.  
  1574.  This tells DeuTex to look in the LEVELS\ subdirectory for PLAGUE.WAD
  1575.  and E3M4.WAD and to combine them in the final PWAD as E1M2 and E3M4.
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                                                  page 17
  1582.  
  1583.  
  1584.  
  1585.  
  1586.                                -------
  1587. B)                              \LUMPS
  1588.                                ------- 
  1589.  
  1590. Lumps are raw data for DOOM with the extension .LMP. If you have
  1591. edited or created any of them for your PWAD, put them here. The
  1592. following files are the LMPs used by DOOM. You can insert something
  1593. else if you like, and DOOM will ignore it. It's a mystery why anyone
  1594. would do this, but WAD builders are a mysterious bunch!
  1595.  
  1596. *********************** Lumps recognized by DOOM **********************
  1597.  
  1598. PLAYPAL.LMP   Color PALETTES (14 of them consisting of 256 RGB triplets
  1599.               each - 768 bytes/palette). The first one contains the
  1600.               normal DOOM colors. The others temporarily 'tint' the
  1601.               screen colors for different events in DOOM. (Item pickup,
  1602.               Hurt and Berserk Reds, Radsuit Green etc...)
  1603.  
  1604. COLORMAP.LMP  Color MAPS.  There are 34 of these,consisting of
  1605.               256 bytes each. These are NOT RGB triplets. They map
  1606.               whatever PLAYPAL currently being displayed by DOOM to
  1607.               darker colors corresponding to the light level in a
  1608.               sector. These mapped colors are what you see on the
  1609.               screen.  The first map (map 0) corresponds to a light
  1610.               level of 247-255, and doesn't change the display at all.
  1611.               The 32nd map (map 31) corresponds to a light level of 0-7
  1612.               and maps almost all colors to the darkest one in the
  1613.               presently use PLAYPAL. Map 32 makes everything black and
  1614.               white for 'invulnerability'. Map 33 is all zeros.
  1615.  
  1616. ENDDOOM.LMP   Text displayed when leaving DOOM. Use A program
  1617.               like TED or ENDOOMER to edit this text.
  1618.               (DO NOT REMOVE THE ID COPYRIGHT!)
  1619.  
  1620. DEMO1.LMP   / Demos recorded by DOOM.
  1621. DEMO2.LMP  <  e.g. DOOM -record DEMO2 -file MYWAD.WAD
  1622. DEMO3.LMP   \ Then move DEMO2.LMP here, and that's all!
  1623.  
  1624. DMXGUS.LMP    (DOOM1)    / Text file remapping MIDI instruments 
  1625. DMXGUSC.LMP   (DOOM2) \ for the Gravis Ultra Sound card.
  1626.  
  1627. GENMIDI       Instrument mapping for GENMIDI compatible cards.
  1628.  
  1629. ***********************************************************************
  1630.  
  1631. Suppose you have edited ENDOOM.LMP and recorded a new DEMO1.LMP  for
  1632. your PWAD. Just put copies of them here, and declare them in the [LUMPS]
  1633. section of WADINFO.TXT like this:
  1634.  
  1635.      [LUMPS]
  1636.      ENDOOM
  1637.      DEMO1
  1638.  
  1639.        This tells DeuTex to look here for ENDOOM.LMP and DEMO1.LMP
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                                                                  page 18
  1648.  
  1649.  
  1650.  
  1651.  
  1652.                              ----------
  1653.  C)                           \TEXTURES
  1654.                              ----------
  1655.  
  1656.  NOTE: DOOM1/HERETIC contains 2 Texture entries, TEXTURE1 and TEXTURE2.
  1657.      this is because of differences between the shareware and registered
  1658.      versions. If you are using DeuTex with DOOM2, just ignore any
  1659.      references to TEXTURE2. It doesn't exist in DOOM2.WAD.
  1660.  
  1661.  This subdirectory contains a text file(s) describing the Texture
  1662.  changes you want in your PWAD (Chapter 8 describes Texture definition
  1663.  files). Your file can be given any name you want (prefer TEXTURE1.TXT
  1664.  or TEXTURE2.TXT). This name (without extension) is then entered in the
  1665.  [TEXTURE1] section of WADINFO.TXT.
  1666.  
  1667.  FILES PUT HERE HAVE THE EXTENSION (.TXT). THE TITLE OF ANY FILE PUT
  1668.  HERE MUST BE DECLARED IN THE [TEXTURE1] SECTION OF WADINFO.TXT.
  1669.  
  1670.  The file names OLDTEX1.TXT and OLDTEX2.TXT are reserved. Due to an
  1671.  amazing bug (in DOOM?), if DOOM's Texture list contains any new or
  1672.  redefined Textures before all the UNCHANGED Textures are listed, it
  1673.  produces HOM (Hall of Mirrors) errors. Previous versions of DeuTex
  1674.  dealt with this problem by requiring a copy of TEXTURE1.TXT (with any
  1675.  redefined Textures deleted) here in the \TEXTURES subdirectory. This
  1676.  is no longer necessary with version 3.3. DeuTex now reads the original
  1677.  TEXTURE1 from the main IWAD while creating your PWAD. It then reads
  1678.  your new Textures and automatically sorts , deletes, and combines all
  1679.  entries. Olivier's too good to you guys >;-]
  1680.  
  1681.  EXAMPLES: 
  1682.  
  1683.  If you want to add ONLY new Textures:
  1684.  
  1685.     - Put your definition file here (e.g. TEXTURE1.TXT), and declare
  1686.       TEXTURE1 in the [TEXTURE1] section of (WADINFO.TXT).
  1687.  
  1688.  If you want to redefine Textures in TEXTURE1:
  1689.  
  1690.     - Run DeuTex -dmtextures to get the Textures.
  1691.     - Cut the Textures to be redefined from OLDTEX1.TXT and paste
  1692.       them into TEXTURE1.TXT. Edit them or change them as you wish.
  1693.     - You can delete OLDTEX2.TXT and OLDTEX1.TXT now if you want.
  1694.     - Declare TEXTURE1 in the [TEXTURE1] section of WADINFO.TXT.
  1695.  
  1696.  If you want to redefine Textures in TEXTURE2:
  1697.  
  1698.      - Run DeuTex -dmtextures to get the Textures.
  1699.      - Cut the Textures to redefine out of OLDTEX2.TXT and put
  1700.        them in TEXTURE2.TXT. Edit and change them as you wish.
  1701.      - You can delete OLDTEX1.TXT and OLDTEX2.TXT now if you want.
  1702.      - Declare TEXTURE2 in the [TEXTURE2] section of WADINFO.TXT.
  1703.  
  1704. APPENDICES I and II contain lists of the animated and switch Textures
  1705. from DOOM.WAD (Not the new ones from DOOM2, sorry. Use DeuTex to make
  1706. your own list). Copy the portion you want to edit into TEXTURE1.TXT.
  1707. It's a little easier than hunting through the entire OLDTEX1.TXT files.
  1708. Beware: some textures change a lot, between DOOM and DOOM2.
  1709.  
  1710.  
  1711.  
  1712.  
  1713.                                                                  page 19
  1714.  
  1715.  
  1716.  
  1717.  
  1718.                               --------------------
  1719. D)                             \SOUNDS and \MUSICS
  1720.                               --------------------
  1721.  
  1722. + Put your new Sound files here in the correct format. They must have
  1723. + the same name as the Sound you want to replace (Appendix IV lists the
  1724. + Sound names used in DOOM1 and DOOM2. It also lists the Sound names for
  1725. + each DMAUD Sound number). Put the Sound NAME (no extension) in the
  1726. + [SOUNDS] section of WADINFO.TXT.
  1727.  
  1728. DeuTex uses the following formats for DOOM Sound files:
  1729.  
  1730. MUSIC:                      (D_xxxxxx.MUS)    for DOOM/DOOM2
  1731.                             (MUS_xxxx.MUS)    for HERETIC
  1732. MUS format (RAW format, which can be created from MIDI
  1733. files with MIDI2MUS.EXE, provided by ddt).
  1734.  
  1735. SOUNDCARD SOUND EFFECTS:    (DSxxxxxx.WAV)    for DOOM/DOOM2
  1736.                             (xxxxxxx.wav)     for HERETIC
  1737. Windows WAVE file (.WAV). Use a converter if you prefer .AU.
  1738. Preferably use 11025 sample/second for your recording.
  1739. VOC format is supported only for 11025 sample/s (DeuTex can't convert).
  1740.  
  1741. PC-SPEAKER:                  (DPxxxxxx.TXT)   only for DOOM
  1742. Text files (.TXT) with numbers 0-255 
  1743.  
  1744. WARNING: DeuTex assumes that any file name beginning with: 
  1745.                      'D_' or 'MUS_' is music.
  1746.                      'DS'           is soundcard sound effect.
  1747.                      'DP'           is PC speaker sound effect.
  1748. + Suppose you've created new music for Level E1M5 called D_E1M5.MUS. You
  1749. + also want to replace DSSHOTGN with a your file called PTOOEY.WAV. You
  1750. + would put the files here and edit your WADINFO.TXT as follows:
  1751. +
  1752. +      [MUSICS]
  1753. +      D_E1M5
  1754. +      [SOUNDS]
  1755. +      DSSHOTGN =PTOOEY
  1756. +
  1757. +         This tells DeuTex to look here for D_E1M5.MUS and PTOOEY.WAV.
  1758. +         It will replace the Sound DSSHOTGN with PTOOEY.WAV
  1759.  
  1760.                              ----------
  1761. E)                            \GRAPHICS
  1762.                              ----------
  1763.  
  1764. For DOOM pictures other than Sprites, Flats or Textures. Put the
  1765. changed Graphic FILE here in .BMP or .GIF format, and enter the NAME
  1766. (without extension) in the [GRAPHICS] section of WADINFO.TXT.
  1767.  
  1768. Suppose you have created a new TITLEPIC.BMP, and want SURRENDR.BMP to
  1769. replace VICTORY2. Just put the files here and declare them in the
  1770. [GRAPHICS] part of WADINFO.TXT, like:
  1771. +
  1772. +    [GRAPHICS]
  1773. +    TITLEPIC
  1774. +    VICTORY2 = SURRENDR
  1775. +
  1776. +     DeuTex will look here for TITLEPIC.BMP and SURRENDR.BMP (or .GIF).
  1777. +     It will use SURRENDR.BMP for VICTORY2.
  1778.  
  1779.                                                                  page 20
  1780.  
  1781.  
  1782.  
  1783.  
  1784. ************ Some examples of Graphic entries in DOOM.WAD *************
  1785.  
  1786. HELP1      The HELP screen for DOOM 1.666.
  1787. HELP2      Second HELP screen for DOOM 1.666.
  1788. HELP       The HELP screen for DOOM 2.
  1789. TITLEPIC   The title pic for Doom (320 x 200).
  1790. CREDIT     The credits for DOOM (Don't touch!).
  1791. VICTORY2   The background of the victory scenes.
  1792. STCFNxx    The fonts for DOOM.
  1793. STxxxxx    Description of the status bar.
  1794. M_xxxxx    Description of the menus.
  1795.  
  1796. You can read Matt Fell's DOOMSPEC for other entries, or extract
  1797. them for yourself with DeuTex -graphic -xtract DOOM.WAD.
  1798.  
  1799.                               ---------
  1800. F)                             \SPRITES
  1801.                               --------- 
  1802.  
  1803. Put your new Sprites here in (.BMP) or (.GIF) format.
  1804.  
  1805. WARNING: DOOM WILL LOCK UP IF YOU ATTEMPT TO REPLACE ONLY SOME OF THE
  1806.          EXISTING SPRITES! Either replace all the Sprites with DEUTEX
  1807.          -iwad -make or replace only some of the Sprites and use DEUSF
  1808.          -add, DEUSF -append or DEUTEX -merge.
  1809.  
  1810. + Suppose you want to redefine SPOSA1 and TROOB2. You want to replace
  1811. + them with SPOSA1.GIF and LIZARD.BMP. Put the files here, and then
  1812. + declare them in the [SPRITES] section of WADINFO.TXT, like:
  1813. +
  1814. +      [SPRITES]
  1815. +      SPOSA1
  1816. +      TROOB2 =LIZARD
  1817. +
  1818. +      DeuTex will look here for SPOSA1.BMP (or .GIF) and LIZARD.BMP.
  1819.  
  1820.                                -------
  1821. G)                              \FLATS
  1822.                                -------
  1823.  
  1824. For new floors and ceilings as 64x64 (.BMP) or (.GIF) files.
  1825.  
  1826. WARNING: TO USE YOUR NEW FLATS, YOU MUST MERGE YOUR PWAD WITH THE MAIN
  1827.          IWAD, OR USE DEUSF TO PUT ALL THE IWAD FLATS INTO YOUR PWAD.
  1828.  
  1829. Sorry, but this is a limitation of DOOM, not of DeuTex. Flats inserted
  1830. here will not crash DOOM when the PWAD is run because I don't use the
  1831. regular F_START F_END delimiters that confuse DOOM. Your PWAD *WILL*
  1832. fail when it references those Flats, so heed the warning above.
  1833.  
  1834. + Suppose you want MUDDY.BMP as a new Flat, and HATCH.GIF to replace
  1835. + FLOOR1_7. Put the FILES here, and declare them in WADINFO.TXT, like:
  1836. +
  1837. +      [FLATS]
  1838. +      MUDDY
  1839. +      FLOOR1_7 =HATCH
  1840. +
  1841. + DeuTex will look here for MUDDY.BMP and HATCH.BMP (Then HATCH.GIF),
  1842. + and replace FLOOR1_7 with HATCH.GIF. BUT, SEE WARNING ABOVE!
  1843.  
  1844.  
  1845.                                                                  page 21
  1846.  
  1847.  
  1848.  
  1849.  
  1850.                               ---------
  1851. H)                             \PATCHES
  1852.                               ---------
  1853.  
  1854. Put new Patches here as (.BMP) or (.GIF). DeuTex will load ANY Patches
  1855. that have the same name as an existing Patch. They don't have to be
  1856. mentioned in MYTEXT.TXT. If you want the man in the danger symbol to be
  1857. a woman, edit the Patch, and throw it in here (use the same name). You
  1858. don't need to redefine all the Textures that contain it.
  1859.  
  1860. WADINFO.TXT contains NO [PATCHES] section. The Texture definition file
  1861. in \TEXTURES describes what Patches go in your new Textures. When DeuTex
  1862. reads WADINFO.TXT, it finds the name of your Texture definition file in
  1863. the [TEXTURE1] section (e.g. TEXTURE1). It finds the file TEXTURE1.TXT
  1864. in \TEXTURES and looks here for any Patches mentioned. Then it looks in
  1865. \PATCHES for pictures defining the patches.
  1866.       If you declare a NEW or MODIFIED Patch in TEXTURE1.TXT,
  1867.       there MUST be a corresponding .BMP or .GIF file in \PATCHES
  1868.  
  1869. EXAMPLE:
  1870.  
  1871. Suppose you want to create a new Texture called MYDOOR, which contains
  1872. two new Patches called WOODEN0 and KNOB0, and a modified WARNA0 Patch.
  1873. The new Texture also contains the existing EXIT1 Patch.
  1874.  
  1875. FIRST: Put WOODEN0.BMP, KNOB0.GIF, and WARNA0.BMP here. 
  1876.  
  1877. THEN: Define your new Texture in TEXTURE1.TXT as shown below:
  1878.  
  1879.       MYDOOR                256   128   ; a 256x128 wall with ...
  1880.       *     WOODEN0           0     0   ; a 256x128 background
  1881.       *     KNOB0            64   100   ; and a small knob at (64,100)
  1882.       *     WARNA0          128    12   ; a lite at top/center
  1883.       *     EXIT1           128    32   ; the word exit in the center
  1884.  
  1885. THEN: Put TEXTURE1.TXT in the \TEXTURES subdirectory.
  1886.  
  1887. THEN: Tell WADINFO.TXT that TEXTURE1.TXT is the file containing new or
  1888.       modified Textures by declaring it in the [TEXTURE1] section:
  1889.  
  1890.    [TEXTURE1]
  1891.    TEXTURE1
  1892.  
  1893. DeuTex will read TEXTURE1.TXT from \TEXTURES. TEXTURE1.TXT tells DeuTex
  1894. that a new texure called MYDOOR is 256 pixels wide, and 128 pixels high.
  1895. The asterisks tell DeuTex to look here for the Patches WOODEN0.BMP,
  1896. KNOB0.BMP, WARNA0.BMP and EXIT1.BMP. The numbers tell it where the
  1897. Patches go on MYDOOR. Note that WOODEN0 had better be 256x128 or bigger,
  1898. or there will be at least one void column, and DOOM will complain and
  1899. stop. If an existing Patch is called for, and no entry by that name
  1900. exists here, the old Patch will be used.
  1901.  
  1902. NOTE:
  1903. DeuTex automatically looks here for ALL Patches mentioned in the
  1904. generated TEXTURE entry. Normally it will check \PATCHES for all kind
  1905. of patches, new patches or patches redefining DOOM patches.
  1906. However, should DeuTex fail to recognise your modifed DOOM patches,
  1907. put this unrecognised patch in \GRAPHICS and declare it explicitly
  1908. in the [GRAPHICS] section of WADINFO.TXT.(The new version of DeuTex
  1909. never demonstrated such a bug, but you never knows, with DOS.)
  1910.  
  1911.                                                                  page 22
  1912.  
  1913.  
  1914.  
  1915.  
  1916. CHAPTER 6
  1917.  
  1918. *************************** DeuTex Commands ***************************
  1919.  
  1920.                       --------------------------
  1921. A)                    COMPLETE COMMAND REFERENCE
  1922.                       --------------------------
  1923.  
  1924. Actually it's not complete, but those commands not mentioned here
  1925. are for the Visual Basic Shell, and you'll never use them. Commands
  1926. with an '*' are not implemented in the VB version. I forgot them.
  1927. All optional commands must appear before non-optional ones or else
  1928. they will be ignored.
  1929.  
  1930. The Command Line Format is:
  1931.  
  1932. DEUTEX <-optional cmd.> ,..., <-non-optional cmd.>,...,etc.
  1933.  
  1934.                              -------------
  1935. B)                           HELP COMMANDS
  1936.                              -------------
  1937.  
  1938.   -help*   This one won't help you a lot, but it
  1939.            will give you the parameters.
  1940.  
  1941.   -syntax* Prints a short listing of the format of WAD creation
  1942.            directives (wadinfo.txt). See the FORMATS Chapter in
  1943.            this manual for a more complete explanation.
  1944.  
  1945.                           -----------------
  1946. C)                        OPTIONAL COMMANDS
  1947.                           -----------------
  1948.  
  1949.   -doom <doom directory>
  1950.  
  1951.             Use this command to indicate the directory containing
  1952.             DOOM.WAD and DOOM.EXE or DOOM2.WAD and DOOM2.EXE.
  1953.  
  1954.             If this command is not used, DeuTex looks first in the
  1955.             current directory for DOOM. Then it looks in the current
  1956.         directory for DOOM2. Then it looks in the root directory of
  1957.             the current drive for a directory called DOOM, and finally
  1958.             looks in the root directory of the current drive for a
  1959.             directory called DOOM2. The first DOOM it finds is used. 
  1960.  
  1961.             EXAMPLE:    DEUTEX -doom C:\GAMES\DOOM
  1962.  
  1963.   -dir <working directory>
  1964.  
  1965.             DEFAULT IS: CURRENT DIRECTORY. This defines the working
  1966.             directory, into which you or DeuTex will put the WAD
  1967.             creation directives (WADINFO.TXT). All subdirectories
  1968.             containing PWAD parts will branch from here. The completely
  1969.             assembled PWAD will also reside here.
  1970.  
  1971.   -deu*     Use this if you want DeuTex to add 64K of junk at the end
  1972.             of your PWAD. Why? To compensate for a bug in DEU 5.21,
  1973.             that makes it sometimes crash when viewing pictures.
  1974.             That bug is corrected in DEU 5.3.
  1975.  
  1976.  
  1977.                                                                  page 23
  1978.  
  1979.  
  1980.  
  1981.  
  1982. + -rgb <R> <G> <B>
  1983. +
  1984. +           Let's you pick what *exact* color DeuTex will use for DOOM's
  1985. +           transparent color. The default is CYAN(R=0, G=255, B=255).
  1986. +
  1987. +           EXPLANATION:
  1988. +           DOOM allows transparent areas in textures. Although there
  1989. +           are 256 colors in the DOOM palette, only 255 of them act
  1990. +           as colors. Color number 247 (CYAN R=0 G=255 B=255) is used
  1991. +           by DOOM as a 'switch' to make that pixel invisible.
  1992. +
  1993. +           When DeuTex imports your new graphics into a PWAD, it must
  1994. +           assign each pixel one of the DOOM colors. For most of the
  1995. +           16 million colors possible in an RGB format such as .BMP
  1996. +           and .GIF, it is just a matter of finding the most appro-
  1997. +           priate colors in the DOOM palette to map to your graphic.
  1998. +           However, CYAN is more of a 'switch' than a color.It wouldn't
  1999. +           be appropriate for DeuTex to say "anything CLOSE to CYAN is
  2000. +           transparent". That would be like saying "anything close to
  2001. +           LINEDEF type 39 is a teleport". Transparency is a switch,
  2002. +           and has to be exact.
  2003. +
  2004. +           Some graphics programs may not be able to meet this re-
  2005. +           quirement. For example, some programs limit you to 64 (0-63)
  2006. +           increments each in Red, Green and Blue. They multiply the
  2007. +           result by 4 to get the true RGB value. This is fine for most
  2008. +           purposes, but not for DOOM.
  2009. +
  2010. +           In any such program, the closest you can get to CYAN is,
  2011. +           0 for Red, 63 for Blue and 63 for Green. When multiplied
  2012. +           to  get a true RGB value, this becomes R=0, G=252,B=252.
  2013. +           You couldn't tell the difference by looking, but DeuTex can.
  2014. +           It will take this value and say "Hmmm... Light Blue". Your
  2015. +           graphic will be disappointing when you see it in DOOM :-<
  2016. +           -rgb 0 252 252 will make you smile again :-)
  2017. +
  2018. +           Another example of when you might want to use this command
  2019. +           is if you use a raytracer to create your graphics. Most of
  2020. +           these programs render the background as black. If you use
  2021. +           the option -rgb 0 0 0, things will be much easier. 
  2022.  
  2023.   -bmp      File format to use when EXTRACTING pictures. DeuTex will
  2024.   -gif      recognize either one when STORING pictures in a PWAD. The
  2025. + -ppm      DOS version defaults to .BMP; the UNIX version defaults to
  2026.             .GIF. Avoid the 24bit BMP format! Use 8bit (256 color) and
  2027.             have the color quantization done by a serious program. Mine
  2028.             works if you need it, but it's lame. See "What are the
  2029.             Palettes For?" in Chapter 1. 
  2030.  
  2031.   -wave     File format to use when EXTRACTING Sounds (DeuTex will
  2032.   -au       recognize either one when INSERTING Sounds). The DOS
  2033. + -voc      version defaults to .WAV; the UNIX version defaults to .AU.
  2034.  
  2035.   -fullsnd* If the real size of the Sound entry is larger than the
  2036.             declared Sound length, -fullsnd enables you to extract
  2037.             the complete Sound entry. It's almost never needed.
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.                                                                  page 24
  2044.  
  2045.  
  2046.  
  2047.  
  2048. +   -level    These tell DeuTex to select Sprites, Patches, Sounds, etc.
  2049. +   -lump     when composing/decomposing/merging PWADS.  These commands
  2050. +   -texture  can be combined.  By default, all entries are selected.
  2051. +   -sound
  2052. +   -graphic
  2053. +   -sprite
  2054. +   -patch
  2055. +   -flat
  2056.      
  2057.   -iwad     To be used with -make, this command makes an IWAD instead
  2058.             of a PWAD. This is necessary if you are building a PWAD
  2059.             which contains all the Sprites and/or all the Flats. This
  2060.             enables you to rebuild the DOOM.WAD if really needed.
  2061.  
  2062.  
  2063.                 --------------------------------------
  2064. D)              COMMANDS TO COMPOSE OR DECOMPOSE PWADS
  2065.                 --------------------------------------
  2066.  
  2067.   -wadir <thatcool.wad>
  2068.  
  2069.             Directory list, with entry identification. Exact
  2070.             entry identification is sometimes impossible in a
  2071.             PWAD. In that case, Sprites, Flats or Patches might
  2072.             be reported as Graphics.
  2073.  
  2074.   -xtract  <thatcool.wad>
  2075.   -extract <thatcool.wad>
  2076.  
  2077.             Will extract Lumps, Graphics, Flats, Patches, Sprites,
  2078.             Sounds and Levels from a WAD and put them into a sub-
  2079.             directory having the same name (all .LMPs in \LUMPS, etc).
  2080.             Also lists any Texture entries of the WAD in a file called
  2081.             TEXTURE1.TXT, which it puts in a subdirectory called
  2082.             \TEXTURES. If you are extracting the main DOOM1 WAD, a
  2083.             second Texture file, TEXTURE2.TXT will be extracted. DOOM2
  2084.             does not have a TEXTURE2 entry. If a given subdirectory
  2085.             does not exist, it will be created. Also creates the file
  2086.             WADINFO.TXT in the working directory. The working directory
  2087.             is the directory the command is entered from unless -dir is
  2088.             used to specify one.  See the Chapter 8 - FORMATS for a
  2089.             description of WADINFO.TXT, TEXTURE1.TXT and TEXTURE2.TXT.
  2090.             This command will not overwrite already existing entries.
  2091.             It will complain and stop instead. 
  2092.  
  2093. +  -dmtextures 
  2094. +
  2095. +           Lists the Textures contained in DOOM.WAD or DOOM2.WAD into
  2096. +           text files, TEXTURE1.TXT and TEXTURE2.TXT (TEXTURE2.TXT
  2097. +           does not exist in DOOM2). The files are deposited in a sub-
  2098. +           directory called \TEXTURES. If \TEXTURES does not exist, it
  2099. +           will be created. This command won't overwrite TEXTURE1.TXT
  2100. +           or TEXTURE2.TXT if they are already present.
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.                                                                  page 25
  2110.  
  2111.  
  2112.  
  2113.  
  2114. -make     <wadinfo.txt>  <myown.wad>
  2115. -build    <wadinfo.txt>  <myown.wad>
  2116. -create   <wadinfo.txt>  <myown.wad>
  2117.  
  2118.             Reads WADINFO.TXT and uses it to compose MYOWN.WAD from the
  2119.             files in the subdirectories. See FORMATS for a description
  2120.             of WADINFO.TXT. MYOWN.WAD will be created in the current
  2121.             directory. If it already exists, it WON'T be overwritten,
  2122.             so it must be deleted or moved to create a new version. This
  2123.             command replaces DMGRAPH, DMMUS, DMTEX and DMAUD. (DMAUD
  2124.             recognises more formats than .WAV and .AU, but it doesn't
  2125.             work with DOOM v1.666 or DOOM2).
  2126.  
  2127. -check  <myown.wad>
  2128.  
  2129.           Will look for any Textures defined in MYOWN.WAD which contain
  2130.           void columns that would crash DOOM. Use this after modifying
  2131.           Textures (Similar to the way you use checks in DEU).
  2132.  
  2133. -unused <thatlame.wad>
  2134.  
  2135.           Checks for unused bytes in a PWAD. Reports all the unused
  2136.           zones, total number of byte wasted, and the repartition
  2137.           depending on size of wasted areas.
  2138.  
  2139.  
  2140.              ---------------------------------------------
  2141. E)           COMMANDS FOR MERGING PWADs INTO THE MAIN IWAD
  2142.              ---------------------------------------------
  2143.  
  2144.  
  2145. -merge  <myown.wad>
  2146.  
  2147.             Will put the entries of MYOWN.WAD into the main DOOM.WAD
  2148.             file, thereby removing all restrictions DOOM puts on PWADS.
  2149.             This is much safer and much cleaner than inserting or
  2150.             restoring entries with DMGRAPH or such, but your IWAD IS
  2151.             modified. Usually used for Sprites and Flats.
  2152.  
  2153. -restore    Will restore DOOM.WAD and the merged MYOWN.WAD.  To be
  2154.             used after the -merge command, to undo the job. Files are
  2155.             reconstructed using information stored in the IWAD at the
  2156.             time the -merge is done.
  2157.  
  2158. + -join     These DeuSF commands are also available for DeuTex
  2159. + -app      -join merges two PWADs, -app appends Sprite and Flats 
  2160. + -add      and -add does the same, but in a new PWAD
  2161.  
  2162. NOTE ON SAFETY:
  2163.                 - ONLY 8 BYTES of DOOM.WAD are modified
  2164.                 - If all else fails, you can restore your IWAD by hand.
  2165.                 - Only about 32k of additional disk space are needed.
  2166.                 - MYOWN.WAD is put INTACT into DOOM.WAD. It can then be
  2167.                   deleted since -restore recreates it. This is barely a
  2168.                   modification at all!
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.                                                                  page 26
  2176.  
  2177.  
  2178.  
  2179.  
  2180. How does it work?
  2181.  
  2182.              - Restoration information is added at the end of the IWAD.
  2183.              - Then the PWAD is pasted intact at the end of the IWAD. 
  2184.              - The IWAD directory is rebuilt (about 32K) and appended.
  2185.              - The pointer to the DOOM directory is modified (8 bytes). 
  2186.  
  2187. I did my best to make this command the safest possible. I have tested
  2188. this command thoroughly and believe it can be trusted. Be aware,
  2189. however, that the resulting IWAD might not work with DOOM if the
  2190. included PWAD does not respect some conventions about Sprites and
  2191. Flats. If this happens, the files are still safe, just -restore them.
  2192.  
  2193. The conventions a PWAD must follow are: 
  2194.  
  2195.         -There must be F_START or FF_START before the first Flat.
  2196.         -There must be S_START or SS_START before the first Sprite.
  2197.  
  2198. Sorry, but there is NO OTHER WAY if we want to be able to add new
  2199. Sprites and Flats that are unreferenced in DOOM.WAD.
  2200. It would be vain to compare the sprites names with those of the IWAD,
  2201. because it's DOOM.EXE that determines which sprites are which, not
  2202. the IWAD. And as DOOM.EXE can be hacked, and sprites vary with versions
  2203. of DOOM, there is really no other choice.
  2204.  
  2205.  
  2206.  
  2207.  
  2208.  
  2209.  
  2210.  
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.                                                                  page 27
  2242.  
  2243.  
  2244.  
  2245.  
  2246. CHAPTER 7
  2247. *************************** DeuSF Commands ****************************
  2248.  
  2249.                               --------
  2250. A)                            OVERVIEW
  2251.                               --------   
  2252.  
  2253. DeuSF is an improved replacement for DMADDS.  It adapts to all versions
  2254. of DOOM, requires a less perverted PWAD structure, and can append to a
  2255. PWAD rather than generating a new PWAD (thereby saving space). DeuSF
  2256. works with PWADs composed for DMADDS, and should work for ones composed
  2257. for DMADDF. Of course, the PREFERRED PWAD composer for DeuSF is DeuTex!
  2258.  
  2259. The code for DeuSF is 80% the same as that of DeuTex. The DeuSF -app
  2260. command is just a modified version of the amazing DeuTex -merge command
  2261. (the ONLY command that removes ALL PWAD limitations :->)
  2262.  
  2263. DeuSF need only be applied to PWADS that contain:
  2264.  
  2265.     -some Sprites to replace those of DOOM.WAD.
  2266.     -some Flats to replace those of DOOM.WAD.
  2267.  
  2268. DeuSF need NOT be used if:
  2269.  
  2270.     - the PWAD contains *all* the Sprites of DOOM.WAD
  2271.     - the PWAD contains *all* the Flats of DOOM.WAD
  2272.     - the PWAD contains Sprites which are not referenced in 
  2273.       DOOM.EXE. (a DeHacked patch is needed to have them work)
  2274.  
  2275. DeuSF can only be used on PWADs that respect a precise format:
  2276.  
  2277.  - Sprites are identified only if comprised between:
  2278.  
  2279.           S_START or SS_START    and    S_END or SS_END 
  2280.  
  2281.  -Flats (floor/ceilings) are identified only if they occur between:
  2282.  
  2283.           F_START or FF_START    and    F_END or FF_END  
  2284.  
  2285. If this format is NOT respected, DeuSF fails to identify entries
  2286. correctly. This is because in IWAD and PWAD entries there is nothing
  2287. internal to a Sprite or Flat that identifies it as such. This format is
  2288. generated by DeuTex automatically, and is compatible with DMADDS.
  2289.  
  2290. DeuSF is meant to be distributed with your PWAD, so it has no
  2291. restrictions on distribution (Unlike DeuTex, see License Section). This
  2292. lets you send DeuSF with your PWAD, along with a batch file like the
  2293. one in the following example. Your PWAD contains new Sprites and Flats,
  2294. but not all of them. Your batch file might read:
  2295.  
  2296.           DeuSF -app mywad.wad
  2297.           DOOM -file mywad.wad -warp x x
  2298.           DeuSF -res mywad.wad
  2299.  
  2300. First, DeuSF appends the Sprites and Flats from DOOM.WAD to mywad.wad.
  2301. Then the PWAD is played. The last command deletes the appended Sprites
  2302. and Flats from mywad.wad, restoring it to it's original condition.
  2303. This kind of PWAD should PREFERABLY be built with DeuTex.
  2304.  
  2305.  
  2306.  
  2307.                                                                  page 28
  2308.  
  2309.  
  2310.  
  2311.  
  2312. An example of DeuSF usage on ALIENDOOM 2.2:
  2313.  
  2314.  DeuSF -doom c:\doom -sprite -add ALIENGFX.WAD ALINGRFX.WAD
  2315.  
  2316.  DeuSF reads ALIENGFX.WAD to find what Sprites are missing. It then
  2317.  extracts them from DOOM.WAD and creates a new PWAD, ALINGRFX.WAD from
  2318.  the original PWAD and the extracted Sprites. DOOM.WAD and the original
  2319.  ALIENGFX.WAD are unchanged.
  2320.  
  2321. Even better:
  2322.  
  2323.  DeuSF -doom c:\doom -sprite -app ALIENGFX.WAD > aliengfx.log
  2324.  
  2325.  DeuSF reads ALIENGFX.WAD to find what Sprites are missing. It then
  2326.  extracts them from DOOM.WAD and appends them to ALIENGFX.WAD. DOOM.WAD
  2327.  is unchanged. If -res doesn't work for any reason, ALIENGFX.WAD can be
  2328.  restored by hand from the information in aliengfx.log
  2329.  
  2330.  You *should* take the time to evaluate this tool even if you're
  2331.  not convinced at all. Trust that this time won't be wasted.
  2332.  DeuSF -join, -merge, -app, -res commands are incredibly more
  2333.  powerfull than those of DMADDS. NWT -as and -af duplicate some of the
  2334.  features of DeuSF, but isn't par to DeuSF yet.
  2335.  Great care involved in designing those DeuSF functions, and DeuSF in not
  2336.  only the most powerfull, it's also the only one ported to other O/S.
  2337.  Let me insist that you should use DeuSF to install your WADs.
  2338.  
  2339.                       --------------------------
  2340. B)                    COMPLETE COMMAND REFERENCE
  2341.                       --------------------------
  2342.  
  2343.  All optional commands must appear before all
  2344.  non-optional ones. Otherwise, they are ignored.
  2345.  
  2346. Command Line Format:
  2347. DeuSF <optional cmd.>,...,<non-optional cmd.>,...,etc.
  2348.  
  2349.  
  2350. ******** 1) HELP COMMANDS
  2351.  
  2352.   -help     Lists these parameters.
  2353.  
  2354.   -format   Displays a summary of the format conventions
  2355.             a PWAD must follow so that DeuSF can recognize
  2356.             Sprites and Flats properly.
  2357.  
  2358.   -wadir <thatcool.wad>
  2359.  
  2360.             Scrolls the entries in the PWAD directory down the screen,
  2361.             along with what type DeuSF thinks each entry is (Sprite,
  2362.             Flat, Graphic, etc.). For a PWAD with many entries, you
  2363.             may want to pipe this command (i.e. DeuSF -wadir | more)
  2364.             to ease readability. Used to check if DeuSF recognises all
  2365.             the entries correctly, for instance when there is a problem
  2366.             with -app or -add.
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                                                                  page 29
  2374.  
  2375.  
  2376.  
  2377.  
  2378. ******** 2) OPTIONAL COMMANDS
  2379.  
  2380.  
  2381.  
  2382.   -doom <doom directory>
  2383.  
  2384.             Use this command to indicate the directory containing the
  2385.             DOOM.WAD and DOOM.EXE you want to use. See the description
  2386.             in  the DeuTex command reference for default information.
  2387.  
  2388.             For example:      DeuSF -doom C:\GAMES\DOOM
  2389.  
  2390.   -sprite   Use with -add or -app, to add only Sprites or only Flats. If
  2391.   -flat     neither of these commands is present, DeuSF will add both.
  2392.  
  2393.  
  2394.  
  2395.  
  2396. ******** 3)  MANDATORY COMMANDS (one of these will always be used)
  2397.  
  2398.  
  2399.  
  2400. -add  <myown.wad> <allsf.wad>
  2401.  
  2402.             Will create a new file, ALLSF.WAD, containing all the
  2403.             Sprites and/or Flats of DOOM.WAD together with those
  2404.             contained in MYOWN.WAD. This is exactly like DMADDS
  2405.             ...but cleaner.
  2406.  
  2407. -app  <myown.wad>
  2408.  
  2409.             Will append to MYOWN.WAD only those Sprites and/or Flats
  2410.             of DOOM which are not redefined. This saves disk space,
  2411.             compared to -add command.
  2412.  
  2413. + -join <this.wad> <that.wad>
  2414. +
  2415. +         Will append to THIS.WAD all the Sprites and Flats contained in
  2416. +         THAT.WAD. This function enables you to merge two Sprite and/or
  2417. +         Flats PWADS obtained from different sources. I added this
  2418. +         command so that I could play CHOOK and BARNEY together.
  2419. +         TEXTURES and PNAMES entries of both THIS.WAD and THAT.WAD.
  2420. +         If entries are conflicting, thoses of THAT.WAD have priority.
  2421. +         Avoid conflicts! -join is not really clever.
  2422. +
  2423. +         NOTE: After using -join on PWADS, you still have to
  2424. +               use -app on the combined PWAD to append the
  2425. +               remaining Sprites and Flats from DOOM.
  2426. +
  2427. + -res <myown.wad>
  2428. +
  2429. +          Restores a PWAD which had been modified with -app command.
  2430. +          Quite safe. Performs the same function as -restore in DeuTex.
  2431. +          If a PWAD was merged inside another one (using -join), then
  2432. +          that PWAD regenerated also. Now *that's* real cool!
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.                                                                  page 30
  2440.  
  2441.  
  2442.  
  2443.  
  2444. CHAPTER 8
  2445.  
  2446. ******************************* FORMATS *******************************
  2447.  
  2448.                       ----------------------------
  2449. A)                     The WAD Creation Directive
  2450.                               WADINFO.TXT
  2451.                       ----------------------------
  2452.  
  2453. ******** 1) OVERVIEW
  2454.  
  2455. The creation directive file is used by the DeuTex -make command to
  2456. compile a PWAD containing all of the desired enhancements. It is
  2457. automatically generated by the -xtract command and placed in the
  2458. working directory (e.g. MYWAD\). You can rename this file whatever you
  2459. like, and reference it when you use the -make or -merge commands.
  2460.  
  2461. + The file lists most of the entries which will be present in the PWAD
  2462. + file (with the exception of PATCHES and PNAMES, see note below). It is
  2463. + structured similarly to a Windows .ini file with sections headed by
  2464. + names enclosed in brackets.It contains up to 7 sections: [LEVELS],
  2465. + [LUMPS], [TEXTURE1], [SOUNDS], [GRAPHICS], [SPRITES] and [FLATS].
  2466. + For DOOM1, there can be an eighth section called [TEXTURE2].
  2467. +
  2468. + All sections are optional. Starting with DeuTex version 3.0, the order
  2469. + of the sections is not critical. The name of the section IS critical,
  2470. + and must be spelled correctly.
  2471.  
  2472. NOTE: There is no [PATCHES] section. Patch loading is automatic. If a
  2473.       new Patch is referenced in a Texture, DeuTex will look for it in
  2474.       \PATCHES. If there is a Patch in \PATCHES with the same name
  2475.       as an existing Patch, DeuTex will automatically find it and load
  2476.       it. There is no need to reference a redefined Patch in a Texture
  2477.       definition, unless it is part of a new or redefined Texture. There
  2478.       is also no need to define PNAMES. PNAMES creation is automatic.
  2479.  
  2480.  The names TEXTURE1 and TEXTURE2 refer to the OLDTEX1.TXT and
  2481.  OLDTEX2.TXT files as extracted from DOOM. Unlike previous versions,
  2482.  DeuTex doesn't need these files. They exist only for you. They are
  2483.  useful in examining the makeup of textures in the WAD. They also make
  2484.  redefining existing Textures easier by allowing you to cut and paste
  2485.  instead of typing the redefined Texture from scratch. DeuTex 3.3 takes
  2486.  all the information on existing Textures directly from the main WAD
  2487.  while building your PWAD. Any new definitions supplied by you will
  2488.  override those in DOOM. A warning will be given to inform you of this.
  2489.  This is a great improvement and makes DeuTex even easier than before!
  2490.  
  2491.  Previous versions of this manual also generated confusion over where,
  2492.  how, and if you need to use OLDTEX2.TXT (then named TEXTURE2.TXT)
  2493.  The short answer from now on is: NOWHERE, NOHOW and NO!
  2494.  
  2495.  Since DeuTex 3.1, [TEXTURE1] and [TEXTURE2] are separate sections.
  2496.  There is ONLY ONE case where you will use [TEXTURE2]. This is when you
  2497.  are using DOOM1 and you redefine a TEXTURE2 Texture. OLDTEX2.TXT does
  2498.  NOT need to be present, even in this situation. Use it for your edits.
  2499.  
  2500.  If your PWAD is for DOOM2, or is for DOOM1 and doesn't change any
  2501.  TEXTURE2 Textures, IGNORE all references to TEXTURE2 in this document! 
  2502.  
  2503.  
  2504.  
  2505.                                                                  page 31
  2506.  
  2507.  
  2508.  
  2509.  
  2510. ******** 2) EXACT FORMAT for WADINFO.TXT
  2511.  
  2512.  
  2513.  
  2514.  The following pages show the exact format for all the entries in a
  2515.  PWAD Creation Directive File (i.e. WADINFO.TXT or YOURNAME.TXT).
  2516.  All main sections are optional. Order of sections is unimportant.
  2517.  
  2518.  
  2519.  The Symbols used in the Format Listing are as follows:
  2520.  
  2521.  
  2522.    SYMBOL                    DEFINITION
  2523. _______________________________________________________________________
  2524. |                        |                                            |
  2525. | x and y                | Numbers for offsets, levels, etc.          |
  2526. |________________________|____________________________________________|
  2527. |                        |                                            |
  2528. | aaaa, bbbb and cccc    | YOUR name for a given item (8 char max).   |
  2529. |________________________|____________________________________________|
  2530. |                        |                                            |
  2531. | qqqq, rrrr and ssss    | VARIABLE parts of a DOOM name.             |
  2532. |________________________|____________________________________________|
  2533. |                        |                                            |
  2534. | CAPITAL LETTERS        | MANDATORY parts of an entry.               |
  2535. |________________________|____________________________________________|
  2536. |                        |                                            |
  2537. | DOOM name '=' aaaa     | DeuTex will insert 'aaaa' as 'DOOM name'.  |
  2538. |________________________|____________________________________________|
  2539. |                        |                                            |
  2540. | brackets [ ]           | Define main sections in the file.          |
  2541. |________________________|____________________________________________|
  2542. |                        |                                            |
  2543. | parentheses ( )        | These entries are optional.                |
  2544. |________________________|____________________________________________|
  2545. |                        |                                            |
  2546. | asterisk    '*'        | Reuse the resource from the previous line. |
  2547. |________________________|____________________________________________|
  2548. |                        |                                            |
  2549. | dot+comma  ';'         | 'Comment' follows. (Windoze standard)      |
  2550. | pound sign  '#'        | 'Comment' follows. Rest of line ignored.   |
  2551. |________________________|____________________________________________|
  2552. |                        |                                            |
  2553. | 'white space' (spaces) | Ignored by DeuTex.                         |
  2554. |________________________|____________________________________________|
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.                                                                  page 32
  2572.  
  2573.  
  2574.  
  2575.  
  2576.               Listing of the Format for WADINFO.TXT:
  2577.  
  2578.  ;
  2579.  ; DeuTex by Olivier Montanuy (montanuy@lannion.cnet.fr)
  2580.  ;
  2581.  ;  PWAD creation directives
  2582.  ;
  2583.  ;
  2584.  [LEVELS]       ; Section to define the Level of your map(s).
  2585.  ;
  2586.  MAPxx (=aaaa)  ; If '=aaaa' and '=bbbb' are used, looks in \LEVELS for
  2587.  ExMy  (=bbbb)  ; aaaa.WAD and bbbb.WAD. If '=aaaa' and '=bbbb' are not
  2588.                 ; used, looks in \LEVELS for MAPxx.WAD and ExMy.WAD.
  2589.                 ; Combines them into one PWAD containing MAPxx and ExMy
  2590.                 ;
  2591.                 ; DeuTex does not care about the internal Level of
  2592.                 ; aaaa.WAD or MAPxx.WAD. It will output the PWAD as
  2593.                 ; whatever MAPxx or ExMy is put here. Easy conversion.
  2594.                 ;
  2595.                 ; ExMy can be E1M1 thru E3M9.
  2596.                 ; MAPxx can be MAP01 thru MAP35.
  2597.                 ; MAPS 33, 34 and 35 will play, but can only be entered
  2598.                 ; by IDCLEV. An EXIT LEVEL switch on 33, 34 and 35 will
  2599.                 ; just return you to DOS.
  2600.                 ;
  2601.                 ; If ExMy and MAPxx are entered in the same PWAD, ExMy
  2602.                 ; will play from DOOM1 and MAPxx will play from DOOM2,
  2603.                 ; IF there are no Texture additions to the PWAD. It is
  2604.                 ; still possible with Textures, but is a can of worms,
  2605.                 ; and you'd better know what you're doing.
  2606.                 ;
  2607.                 ; Thus, it is possible to make a 62 Level PWAD with
  2608.                 ; DeuTex, although some imagination would be needed to
  2609.                 ; overcome the limitations of Levels 33, 34 and 35 in
  2610.                 ; DOOM2, and only about half the wad would be available
  2611.                 ; to each DOOM engine. This may be useless, but since
  2612.                 ; it's possible, it is included here.
  2613.  ;
  2614.  ;
  2615.  [LUMPS]       ; Section to define any .LMP data you want to add.
  2616.                ; Chapter 5, Section B) describes Lumps.
  2617.  ;
  2618.  qqqq (=aaaa)  ; If '= aaaa' is used, looks in \LUMPS for aaaa.LMP. If
  2619.                ; '= aaaa' is not used, looks for qqqq.LMP. Installs the
  2620.                ; .LMP data in the PWAD to replace qqqq in DOOM.
  2621.  ;
  2622.  rrrr    (*)   ; If '*' is used, .LMP from the previous entry is used
  2623.                ; for this entry as well. When you play the PWAD, qqqq
  2624.                ; will be used for both qqqq AND rrrr.
  2625.  ;
  2626.  ;
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.                                                                  page 33
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  [TEXTURE1]  ; Section for declaring what Texture definition files you
  2643.              ; want to use when compiling your PWAD.
  2644.  ;
  2645.   aaaa       ; First loads TEXTURE1 from the main DOOM or DOOM2 WAD.
  2646.  (bbbb)      ; Then looks in \TEXTURES for aaaa.TXT. Compiles your PWAD
  2647.  (cccc)      ; Texture directory by: TEXTURE1 - (redefined Textures in
  2648.              ; aaaa.TXT)+(ALL textures in aaaa.TXT) = TEXTURE1 in PWAD.
  2649.              ;
  2650.              ; If 'bbbb' and 'cccc' are used, DeuTex searches for
  2651.              ; bbbb.TXT in \TEXTURES, RE-edits the TEXTURE1 entry using
  2652.              ; it, then gets cccc.TXT and repeats the process. This
  2653.              ; means that if any duplicate Texture names exist in aaaa,
  2654.              ; bbbb and cccc, only the entry from the last file listed
  2655.              ; will be present in the final PWAD.
  2656.  ;
  2657.  [TEXTURE2]  ; Used only for DOOM1. Shows what Texture definition
  2658.  aaaa        ; file(s) to use for TEXTURE2. Similar to above.
  2659.  ;
  2660.  ;
  2661.  [SOUNDS]        ; Section to define your modified Sound entries.
  2662.  ;
  2663.  DSqqqq (=aaaa)  ; If '=aaaa' is used, looks in \SOUNDS for aaaa.WAV
  2664.                  ; (Sound effect). If '= aaaa' isn't used, looks for
  2665.                  ; DSqqqq.WAV. Uses file to replace DOOM sound DSqqqq.
  2666.  ;
  2667.  DPqqqq (=aaaa)  ; If '=aaaa' is used, looks in \SOUNDS for aaaa.TXT
  2668.                  ; (PC Speaker Sound). If '= aaaa' is not used, looks
  2669.                  ; in \SOUNDS for DPqqqq.TXT. Uses file to replace
  2670.                  ; DOOM PC Speaker Sound DPqqqq.
  2671.  ;
  2672.  D_qqqq (=aaaa)  ; If '=aaaa' is used, looks in \SOUNDS for aaaa.MUS
  2673.                  ; (Music file in  DOOM's .MUS format). If '=aaaa' is
  2674.                  ; not used, looks for D_qqqq.MUS. Uses file to replace
  2675.                  ; DOOM Music D_qqqq.
  2676.  ;
  2677.  D_rrrr   (*)    ; If '*' is used, the Sound from the previous entry is
  2678.                  ; used for this entry as well. In this example, when
  2679.                  ; you play your PWAD, D_qqqq will be used for both
  2680.                  ;  D_qqqq AND D_rrrr.
  2681.  ;
  2682.  ;
  2683.  [GRAPHICS]             ; Section used to declare Graphics other than
  2684.                         ; Sprites, Flats, or Textures. See Chapter 5,
  2685.                         ; Section E) or Matt Fell's DOOM SPECs for a
  2686.                         ; description of Graphic entries in DOOM.
  2687.  ;
  2688.  qqqq (xx)(yy) (=aaaa)  ; If '=aaaa' is used, looks in \GRAPHICS for
  2689.                         ; aaaa.BMP. If not found, looks for aaaa.GIF.
  2690.                         ; If '=aaaa' is not used, looks for qqqq.BMP
  2691.                         ; or .GIF. Inserts the file in PWAD for entry
  2692.                         ; qqqq. xx and yy are the horizontal and
  2693.                         ; vertical offsets used when inserting the
  2694.                         ; Graphic into it's defined area. The defined
  2695.                         ; defined area is predetermined by DOOM.EXE
  2696.                         ; from the Graphic name.
  2697.                         ;
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.                                                                  page 34
  2704.  
  2705.  
  2706.  
  2707.  
  2708.                         ; For example, all Graphics beginning with STF
  2709.                         ; are placed in a box 31 x35 pixels big at the
  2710.                         ; center of the Status Bar. This is where the
  2711.                         ; player's face shows up. The xx and yy values
  2712.                         ; move the Graphic around in this box. Pos-
  2713.                         ; itive values move it left (xx) and up (yy).
  2714.  ;
  2715.  rrrr        (*)        ; If '*' is used, will re-use the Graphic from
  2716.                         ; the previous line for rrrr too.
  2717.  ;
  2718.  ;
  2719.  [SPRITES]              ; Section used to declare Sprites. Consult the
  2720.                         ; following for more information on modifying
  2721.                         ; Sprites in DOOM:
  2722.                         ;   Chapter 3 - Section C)
  2723.                         ;   Chapter 5 - Section F)
  2724.                         ;   Chapter 6 - Section E)
  2725.                         ;   Chapter 7 - All Sections
  2726.  ;
  2727.  qqqq (xx)(yy) (=aaaa)  ; If '=aaaa' is used, looks for aaaa.BMP or
  2728.                         ; .GIF in \SPRITES. If '=aaaa' is not used,
  2729.                         ; looks for qqqq.BMP or GIF. Inserts the file
  2730.                         ; into the PWAD to replace the Sprite qqqq.
  2731.  ;
  2732.  rrrr          (*)      ; '*' tells DeuTex to use the previous entry
  2733.                         ; (qqqq) for this Sprite as well.
  2734.  ;
  2735.  ;
  2736.  [FLATS]       ; Section for declaring modified Flats. Limitations
  2737.                ; are similar to the ones for modifying Sprites. See
  2738.                ; [SPRITES] section above for places to find info.
  2739.  ;
  2740.  qqqq (=aaaa)  ; If '=aaaa' is used, looks for aaaa.BMP or .GIF in
  2741.                ; \FLATS. If '=aaaa' is not used, looks for qqqq.BMP or
  2742.                ; .GIF. Inserts file into PWAD as replacement for qqqq.
  2743.                ;
  2744.                ; There are no insertion points for Flats, since they
  2745.                ; all MUST be 64x64.
  2746.  ;
  2747.  ;
  2748.  ; End File.
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.                                                                  page 35
  2770.  
  2771.  
  2772.  
  2773.  
  2774. ******** 3) An EXAMPLE LISTING of WADINFO.TXT 
  2775.  
  2776. The following is a commented example of PWAD creation directives,
  2777. A space or any text after a ';' or '#' to the end of a line is ignored.
  2778. Not all entries need be present, and order of [SECTIONS] is optional.
  2779.  
  2780. ************************ WADINFO.TXT *****************************
  2781. ;
  2782. ; The [LEVELS] section defines the DOOM1 Levels and DOOM2 maps.
  2783. ;
  2784. [LEVELS]
  2785. E1M2                    ;file loaded: LEVELS\E1M2.WAD
  2786. MAP04                   ;file loaded: LEVELS\MAP04.WAD
  2787. E2M3 =TRINITY        ;file loaded: LEVELS\TRINITY.WAD
  2788.             ;if more than one Level, E2M3 is read
  2789. ;
  2790. ;          All .WADs referred to here must contain the 11 entries that
  2791. ;          define a Level, including NODES, BLOCKMAP and REJECT. Use
  2792. ;          IDBSP and RMB to build them.
  2793. ;
  2794. ; The [LUMPS] section defines the Lumps of raw data for DOOM.
  2795. ;
  2796. [LUMPS]
  2797. ENDOOM                   ;file loaded: LUMPS\ENDOOM.LMP
  2798. DEMO1                    ;file loaded: LUMPS\DEMO1.LMP
  2799. DEMO2 =KILLJOHN          ;file loaded: LUMPS\KILLJOHN.LMP
  2800. ;
  2801. ; See Directory Structure - LUMPS\ for a precise description of all
  2802. ; these entries. Apart from the DEMO or possibly ENDOOM, there is no
  2803. ; real need to mess with them. DEMOs can be recorded by DOOM.
  2804. ;
  2805. ; The [TEXTURE1] section lists the names of the Texture definition files
  2806. ; from \TEXTURES that are to be used for TEXTURE1.
  2807. ;
  2808. [TEXTURE1]        ;DeuTex will first read TEXTURE1 in DOOM.WAD
  2809. ;
  2810. TEXTURE1      ;file read: \TEXTURES\TEXTURE1.TXT
  2811. MYWALLS           ;file read: \TEXTURES\MYWALLS.TXT
  2812. MYSWITCH          ;file read: \TEXTURES\MYSWITCH.TXT
  2813. ;
  2814. ;     The new Textures found in these files are placed at the end of the
  2815. ;     Texture list. If they have the same name as an entry in OLDTEX1,
  2816. ;     (that is: the old DOOM texture) then that entry is deleted.
  2817. ;
  2818. ; The [TEXTURE2] entry is not needed for DOOM2
  2819. ;
  2820. [TEXTURE2]        ;DeuTex will first read TEXTURE2 in DOOM.WAD.
  2821. ;
  2822. TEXTURE2            ;file read: \TEXTURES\TEXTURE2.TXT
  2823. ;
  2824. ;     The new Textures found in this file are placed at the end of the
  2825. ;     Texture list. If they have the same name as an entry in TEXTURE2,
  2826. ;     that entry is deleted.
  2827. ;
  2828. ;         BEWARE: don't duplicate TEXTURE1 entries in TEXTURE2.
  2829. ;                 DOOM Doesn't care, but it crashes some Level
  2830. ;                 editors.
  2831. ;
  2832.  
  2833.  
  2834.  
  2835.                                                                  page 36
  2836.  
  2837.  
  2838.  
  2839.  
  2840. ; The [MUSICS] section defines MUSIC
  2841. ;
  2842. D_E2M3            ;file loaded: SOUNDS\D_E2M3.MUS   (doom1 music).
  2843. D_RUNNIN          ;file loaded: SOUNDS\D_RUNNIN.MUS (doom2 music).
  2844. D_ROMERO    *     ;no file loaded! The '*' copies D_RUNNIN to D_ROMERO.
  2845.           ;now DOOM will think D_ROMERO=D_RUNNIN.
  2846. D_SHAWN3 =KATEBUSH      ;file loaded: SOUNDS\KATEBUSH.MUS.
  2847.             ;The music for SHAWN3 will be KATEBUSH.
  2848. ;
  2849. ;   D_E2M3 is the music for Episode2 Mission 3 of DOOM.
  2850. ;   In DOOM2, it's a real mess. The Music name is not related
  2851. ;   to the Level name, but to the guy who made the Level.
  2852. ;  MUS format can be obtained from MIDI with MIDI2MUS, or
  2853. ;  converted back to MIDI by MUS2MIDI (by just_joe).
  2854. ;  These are separate utilities (too technical for DeuTex)
  2855. ;
  2856. ; The [SOUNDS] section defines PCSOUNDS and WAVE SOUNDS
  2857. ;
  2858. [SOUNDS]
  2859. DSSLOP                  ;file loaded: SOUNDS\DSSLOP.WAV, .AU or .VOC
  2860. DSPISTOL =BOIING        ;file loaded: SOUNDS\BOIING.WAV, .AU or .VOC
  2861.             ;this is a WAV Sound, meant for sound cards.
  2862. ;
  2863. DPSLOP                  ;file loaded: SOUNDS\DPSLOP.TXT
  2864.             ;this is a PC speaker Sound.
  2865. ;
  2866. ;     The WAV, AU and VOC format were hacked.
  2867. ;     DeuTex can't read compressed data.
  2868. ;     The format PC-speaker Sound is a list of integers
  2869. ;     (range 1-255). related to sound pitch...
  2870. ;
  2871. ;
  2872. ; The [GRAPHICS] section defines all the fixed pictures.
  2873. ; (Not Sprites, Patches, or Flats)
  2874. ;
  2875. [GRAPHICS]
  2876. WIMAP1                         ;file loaded:  GRAPHICS\WIMAP1.BMP.
  2877. STHURT1    23    45            ;file loaded:  GRAPHICS\STHURT1.BMP.
  2878.                    ;set the insertion point to 23,45.
  2879. STHURT2           *            ;DOOM will use STHURT1 for STHURT2.
  2880. VICTORY2   0     12 =SULACCO   ;file loaded: GRAPHICS\SULACCO.BMP
  2881.                    ;set the insertion point to 0,12.
  2882.                    ;SULACCO.BMP will now replace VICTORY2.
  2883. ;
  2884. ; Fixed pictures include: opening screen,
  2885. ; texts (!), menus, status bar, ending pictures ...
  2886. ; You can only use names already defined in DOOM.
  2887. ; Otherwise DOOM will ignore them. (you'll be warned :-)
  2888. ;
  2889. ; This section declares the Sprites.
  2890. ;
  2891. [SPRITES]
  2892. BOSSB1                      ;File loaded: SPRITES\BOSSB1.BMP or .GIF
  2893.                 ;calculate insertion point by itself.
  2894. BOSSA1   10  20            ;File loaded: SPRITES\BOSSA1.BMP or .GIF
  2895.                 ;set the insertion point to 10,20.
  2896. BOSSA2A8    *               ;DeuTex will set BOSSA2A8 equal to BOSSA1
  2897. VILEA1   30   40 =BILLGATE  ;File loaded: SPRITES\BILLGATE.BMP or .GIF
  2898.                 ;VILEA1 will now be BILLGATE.BMP
  2899.  
  2900.  
  2901.                                                                  page 37
  2902.  
  2903.  
  2904.  
  2905.  
  2906. ; If you redefine ALL Sprites, use the -iwad option.
  2907. ; Otherwise, you'll have to use DeuSF to rebuild a complete Sprite PWAD
  2908. ; each time the WAD is played. This is because of a limitation of DOOM
  2909. ; which still has not been removed (ask ID software about it).
  2910. ;
  2911. ;
  2912. ; Don't declare your Patches.
  2913. ; A Patch, say xxxx, will automatically be loaded into
  2914. ; the PWAD from the file PATCHES\xxxx.BMP (or .GIF) if:
  2915. ;
  2916. ;         'xxxx' is referenced in one of the Texture files, as a Patch.
  2917. ;      or 'xxxx' exists as a Patch in the original DOOM.
  2918. ;
  2919. ;
  2920. ;
  2921. ; The [FLATS] section declares the Floors and Ceilings
  2922. ;
  2923. [FLATS]
  2924. GRASS                 ;file loaded: FLATS\GRASS.BMP (or .GIF)
  2925. HERBE       *         ;DOOM will think HERBE is the same as GRASS
  2926. BLOOD1 = MUDDY        ;file loaded: FLATS\MUDDY.BMP
  2927.               ; All these files must be 64x64 pixel pictures.
  2928. ;
  2929. ; You can define new Flat names, or redefine existing Flats, but unless
  2930. ; you redefine the complete list of Flats, and use the -iwad option, you
  2931. ; need to use DeuSF to rebuild the complete Flat list whenever you want
  2932. ; to use the PWAD.
  2933. ;
  2934. ;
  2935. ; WAD creation directives end here.
  2936. ;
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.                                                                  page 38
  2968.  
  2969.  
  2970.  
  2971.  
  2972.                   -----------------------------------
  2973. B.                 The Texture Definitions Text File
  2974.                          \TEXTURES\MYTEXT.TXT
  2975.                   -----------------------------------
  2976.  
  2977. ******** 1) OVERVIEW
  2978.  
  2979. Some Notes on Texture definitions:
  2980.  
  2981.      - READ the DOOM SPECS by Matt Fell.
  2982.      - You can create Textures for transparent walls (see DeuTex
  2983.        Commands -rgb), but make sure that they're composed of only
  2984.        one Patch. Otherwise, you'll get the Medusa Effect.
  2985.      - Avoid using a Texture less than 128 pixels high on a
  2986.        wall higher than the Texture (Tutti Frutti effect).
  2987.      - Texture widths should be rounded to the next power
  2988.        of 2. (8,16,64,128,256,512,1024 are usable)
  2989.      - Patches composing Textures can not be more than 320 pixels wide.
  2990.      - DOOM will ignore any portion of Textures higher than 128 pixels. 
  2991.      - You can create a non repeating sky Texture:
  2992.        Define the SKY1 (or SKY2, SKY3, RSKY1, RSKY2, RSKY3) entry as a
  2993.        1024x128 area cover it with Patches. Note that SKY Patches appear
  2994.        horizontally inverted. 0=east,  256=north, 512=west, 768=south.
  2995.      - Make sure all Textures are completely covered by Patches.
  2996.        Otherwise, DOOM will puke (void column error).
  2997.      - You can create animated walls with (almost) any sequence of
  2998.        pictures. No known limit in the number of frames (27 is OK!).
  2999.        The way to do this is:
  3000.        Edit the Textures of one of DOOM's existing animated walls
  3001.        (beginning and end). Use the original names for these entries.
  3002.        They are coded into DOOM.EXE. Add the other frames for your
  3003.        animation between these entries in your Texture list.
  3004.      - READ the DOOM SPE.... Well, you get the picture >;-{]>
  3005.  
  3006. Once you have created a new PWAD, check it with the -check command.
  3007. DeuTex will complain if:
  3008.  
  3009.      - Any Texture width is NOT a power of 2 (2,4,8,16,32,64,128,etc).
  3010.        (DOOM will round to the next lower power of 2)
  3011.      - Any Texture height is greater than 128.
  3012.      (DOOM ignores everything above 128)
  3013.      - Any Texture is not completely covered by Patches.
  3014.        (DOOM will exit with a void column error)
  3015.      - A Level tries to use of an undefined Texture.
  3016.  
  3017. A Texture entry consists of:
  3018.  
  3019. (Texture Name)      (WIDTH) (HEIGHT)
  3020. *     (Patch1)    (X offset)(Y offset)
  3021. *     (Patch2)    (X offset)(Y offset)
  3022. *     (Patch3)    (X offset)(Y offset)
  3023.  .          .          .         .
  3024.  .          .          .         .
  3025.  .          .          .         .
  3026. *     (PatchN)    (X offset)(Y offset)
  3027.  
  3028. This format is supported by both New Wad Tool and the Visual Basic
  3029. shell for DeuTex, so use the one you prefer, to build your Textures.
  3030.  
  3031.  
  3032.  
  3033.                                                                  page 39
  3034.  
  3035.  
  3036.  
  3037.  
  3038. Texture Names are 8 characters or less.
  3039. Width and Height are in pixels.
  3040. An asterisk '*' identifies the following word as a PNAME.
  3041. Patch Names are 8 characters or less.
  3042. X and Y offsets are pixel measurements.
  3043. Offsets are measured from upper-left corner (0,0).
  3044. X = positive. Offset Patch to the right.
  3045. X = negative. Offset Patch to the left.
  3046. Y = positive. Offset Patch down.
  3047. Y = negative. Offset Patch up.
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054. The following figure is a feeble attempt to illustrate this:
  3055.  
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  _______________________  
  3061. |                       | ^
  3062. | PATCH 1               | | 
  3063. | Both x and y          | Y  
  3064. | have negative         | |
  3065. | offsets.       _______|_v_______________________________________    
  3066. |               |       |              ^                          |   ^
  3067. |               |       |              |          TEXTURE         |   |
  3068. |               |       |              |                          |   |
  3069. |               |       |              Y                          |   |
  3070. |               |       |              |                          |   |
  3071. |_______________|_______|              |                          |   H
  3072.                 |                    __v_______________________   |   E
  3073.  <----- X ----->|                   |                          |  |   I
  3074.                 |                   |     PATCH 2:             |  |   G
  3075.                 |                   |     Both x and y have    |  |   H
  3076.                 |<------- X ------->|     positive offsets.    |  |   T
  3077.                 |                   |                          |  |   |
  3078.                 |                   |                          |  |   |
  3079.                 |                   |                          |  |   |
  3080.                 |                   |__________________________|  |   |
  3081.                 |                                                 |   |
  3082.                 |_________________________________________________|   v
  3083.                                                                       
  3084.                  <-------------------- WIDTH --------------------->
  3085.  
  3086.  
  3087.  
  3088.                 TEXTURE DEFINITION SHOWING PATCH OFFSETS
  3089.  
  3090.  
  3091.  
  3092.  
  3093.  
  3094.  
  3095.  
  3096.  
  3097.  
  3098.  
  3099.                                                                  page 40
  3100.  
  3101.  
  3102.  
  3103.  
  3104. ******** 2) An EXAMPLE LISTING of MYTEXT.TXT 
  3105.  
  3106.                     Texture Definition File Example
  3107.  
  3108. *************************** TEXTURE1.TXT ******************************
  3109. ;
  3110. ; Anything following a ';' or ';' is ignored (comment).
  3111. ;
  3112. ; An asterisk '*' at the beginning of a line indicates a Patch.
  3113. ;
  3114. ; ASHWALL is a Texture 64 pixels wide, and 128 pixels high.
  3115. ; It contains only one Patch, W104_1, with no offset.
  3116. ;
  3117. ASHWALL                 64    128
  3118. *     W104_1             0     0
  3119. ;
  3120. ; BIGDOOR7 is a Texture of size 256x128 (X size, Y size) composed of two
  3121. ; Patches, W105_1 and W105_1 placed at offset -4,-4  and offset 124, -4.
  3122. ;
  3123. BIGDOOR7                256   128
  3124. *     W105_1             -4    -4
  3125. *     W105_1            124    -4
  3126. ;
  3127. ; FLOWER is a new Texture (didn't exist in DOOM.WAD).
  3128. ; It is composed of an old Patch.
  3129. ;
  3130. FLOWER                   32   128
  3131. *     TP5_1               0     0
  3132. ;
  3133. ; BLODGR2 redefines the old BLODGR2 Texture
  3134. ; to be composed of the new Patch BIRDY
  3135. ;
  3136. BLODGR2                  34   128
  3137. *     BIRDY               0     0
  3138. ;
  3139. ; A new Texture, HADDOCK, composed of new and old Patches.
  3140. ;
  3141. HADDOCK                  64   128
  3142. *     FISH1               0     0
  3143. *     BIGFISH            23    44
  3144. *     TP5_1               0     0
  3145. ;
  3146. ; Example of wall animation.
  3147. ;
  3148. ; Start with the first entry of an existing animation (FIREBLU1).
  3149. ; Insert additional entries as needed for your animation (ZZZ...).
  3150. ; End with the closing entry of the existing animation (FIREBLU2).
  3151. ; When FIREBLU1 is used in your PWAD, it will have your animation!
  3152. ; Notice that the example uses Sprites as Patches. DOOM don't know
  3153. ; and DOOM don't care!
  3154. ;
  3155. FIREBLU1                128   128     ;First frame is a redefined
  3156. *     WALL62_1            0     0     ;DOOM animated Texture. These
  3157. *     BOSSA1             83    47     ;are called in the DOOM.EXE.
  3158. *     GOR2A0             20   -70
  3159. ZZZA                    128   128     ;Frame  2 inserted.
  3160. *     WALL62_1            0     0
  3161. *     BOSSB1             75    47
  3162. *     GOR2A0             20   -50
  3163.  
  3164.  
  3165.                                                                  page 41
  3166.  
  3167.  
  3168.  
  3169.  
  3170. ZZZB                    128   128     ;Frame  3 inserted.
  3171. *     WALL62_1            0     0
  3172. *     BOSSC1             71    47
  3173. *     GOR2A0             20   -35
  3174. ZZZC                    128   128     ;Frame  4 inserted.
  3175. *     WALL62_1            0     0
  3176. *     BOSSD1             61    47
  3177. *     GOR2A0            20    -25
  3178. ZZZD                    128   128     ;Frame  5 inserted.
  3179. *     WALL62_1            0     0
  3180. *     BOSSF1             47    47
  3181. *     GOR2A0             20   -20
  3182. ZZZE                    128   128     ;Frame  6 inserted.
  3183. *     WALL62_1            0     0
  3184. *     BOSSE8             54    47
  3185. *     GOR2A0             20   -17
  3186. ZZZF                    128   128     ;Frame  7 inserted.
  3187. *     WALL62_1            0     0
  3188. *     BOSSE7             68    47
  3189. *     GOR2A0             20   -16
  3190. ZZZG                    128   128     ;Frame  8 inserted.
  3191. *     WALL62_1            0     0
  3192. *     BOSSE6             64    47
  3193. *     GOR2A0             20   -17
  3194. ZZZH                    128   128     ;Frame  9 inserted.
  3195. *     WALL62_1            0     0
  3196. *     BOSSF5             60    47
  3197. *     GOR2A0             20   -20
  3198. ZZZI                    128   128     ;Frame 10 inserted.
  3199. *     WALL62_1            0     0
  3200. *     BOSSF4             63    47
  3201. *     GOR2A0             20   -25
  3202. ZZZJ                    128   128     ;Frame 11 inserted.
  3203. *     WALL62_1            0     0
  3204. *     BOSSD2D8           64    47
  3205. *     GOR2A0             20    35
  3206. ZZZK                    128   128     ;Frame 12 inserted.
  3207. *     WALL62_1            0     0
  3208. *     BOSSB1             68    47
  3209. *     GOR2A0             20   -50
  3210. ZZZL                    128   128     ;Frame 13 inserted.
  3211. *     WALL62_1            0     0
  3212. *     BOSSC1             70    47
  3213. *     GOR2A0             20   -70
  3214. FIREBLU2                128   128     ;Fourteenth Frame is an
  3215. *     WALL62_1            0     0     ;edited FIREBLU2, which is
  3216. *     BOSSB1             73    47     ;the last frame of the
  3217. *     GOR2A0             20   -64     ;DOOM animated Texture.
  3218. ;
  3219. ; End of example
  3220. ;
  3221. ;
  3222. ; file ends here. bye!
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.                                                                  page 42
  3232.  
  3233.  
  3234.  
  3235.  
  3236.                       ---------------------------
  3237.           *** [PART THREE]   ALL THE REST ***
  3238.                       ---------------------------
  3239.  
  3240.  
  3241. CHAPTER 9
  3242. *************************** NECESSARY STUFF ***************************
  3243.  
  3244.  
  3245.  
  3246.                      ------------------------------
  3247. A)                   DeuTex/DeuSF License Agreement
  3248.                      ------------------------------
  3249.  
  3250.  
  3251.           DeuTex/DeuSF is copyright (c) Olivier Montanuy 1994.
  3252.           The GIF code was from a source (c) David Koblas.
  3253.           DeuTex code was originally derived from DEU5.21 
  3254.          by Brendon Wyber and Raphael Quinet.
  3255.           DeuSF is inspired from DMADDS by Bernd Kreimeier
  3256.  
  3257.  
  3258. DeuTex/DeuSF is a Freeware set of tools.
  3259. DeuTex is Freeware but NOT public domain.
  3260. DeuSF can be freely distributed with PWADS as part of their install.
  3261.  
  3262. Here are the restrictions on the usage of DeuTex:
  3263.  
  3264. - You shall not use these tools to extract or insert copyrighted
  3265.   material in DOOM IWADs and PWADs. You are especially not allowed
  3266.   to use them to build any 'shareware' DOOM version.
  3267.  
  3268. - You are not allowed to modify or reverse engineer these tools.
  3269.   (sources will be available to you if I feel you can be trusted)
  3270.  
  3271. - You cannot distribute these tools commercially without my written
  3272.   consent. This includes all kind of non free distribution (shareware,
  3273.   charging for uploads, or selling it on any kind of media).
  3274.  
  3275.  
  3276. *Compuserve is allowed to distribute DeuTex/DeuSF without restrictions*
  3277.  
  3278.  
  3279. - Anything you build with this tool shall be free for everyone,
  3280.   unless you get written permission from me. 
  3281.  
  3282. - DeuTex must be distributed with all the files in this package,
  3283.   including DeuSF, the manual and this license. Only DeuSF can be
  3284.   distributed separately, for reasons mentioned above.
  3285.  
  3286. - I will accept no liability for any damage resulting from the use
  3287.   of this program. Remember it is freeware. There is no evil intent
  3288.   anywhere in the source of this program, but I can't guess what the
  3289.   compilers might have hacked out of it, or how your system will feel
  3290.   about it.
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.                                                                  page 43
  3298.  
  3299.  
  3300.  
  3301.  
  3302.                               -----------
  3303. B)                            Legal Stuff
  3304.                               -----------
  3305.  
  3306.  
  3307. ***********************************************************************
  3308. *  Please DON'T bother ID software, Raphael Quinet, Brendon Wyber,    *
  3309. *  or any of the people mentioned in this manual, with questions      *
  3310. *  related to DeuTex                                                  *
  3311. ***********************************************************************
  3312.  
  3313.  
  3314.  If you need information, here are the only sources:
  3315.  
  3316.   Olivier Montanuy  (DOS and Unix problems)
  3317.   Kevin McGrail     (Manual and Explanations)
  3318.   Mark Mathews      (OS/2 problems)
  3319.   Per Allansson     (Linux problems)
  3320.  
  3321. Why is DeuTex Copyrighted? It's so that I can make the following
  3322. requirement, which would be impossible with Public Domain status:
  3323.  
  3324.      YOU ARE NOT ALLOWED TO MAKE ANY MODIFICATIONS TO
  3325.      THIS PROGRAM OR TO THE INCLUDED FILES. ALL THE FILES
  3326.      INCLUDED IN THIS PACKAGE SHALL BE RELEASED TOGETHER.
  3327.  
  3328.       If you want modifications, ask me, I'll do my best. 
  3329.       Later on I'll release the source, when stabilized.
  3330.  
  3331.      USE AT YOUR OWN RISK. NO LIABILITY IS ACCEPTED.
  3332.  
  3333.       It runs under DOS, so behavior is unpredictable .
  3334.  
  3335.      YOU ARE NOT ALLOWED TO MAKE ANY KIND OF PERSONAL
  3336.      PROFIT BY SELLING, RENTING, LEASING, OR USING THIS
  3337.      PROGRAM, WITHOUT MY EXPLICIT WRITTEN CONSENT.
  3338.  
  3339. If you are interested in distributing it on a CD or any
  3340. other media, contact me first. I should accept, provided:
  3341.  
  3342.                  - you keep the price low, for maximum availability.
  3343.                  - you send me a free copy.
  3344.  
  3345.  
  3346. SPECIAL EXCEPTION:
  3347.  
  3348. CompuServe is allowed to charge normal upload fees to distribute this
  3349. program, provided I receive (by e-mail) a monthly report of the total
  3350. number of said uploads.
  3351.  
  3352.  
  3353. * All right folks, it was a shame, but it had to be stated somewhere...
  3354.  
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.                                                                  page 44
  3364.  
  3365.  
  3366.  
  3367.  
  3368.                      -------------------------
  3369. C)                   Where to get DeuTex/DeuSF
  3370.                      -------------------------
  3371.  
  3372.  
  3373.  
  3374.         DeuTex and DeuSF are meant to be available by anonymous
  3375.         FTP on Internet sites: the same as of those of DEU:
  3376.  
  3377.                 infant2.cdrom.com,ftp.luth.se,iglou.com,...
  3378.                 /pub/doom/deu
  3379.                 /pub/doom/wad_edit/misc      
  3380.  
  3381.  
  3382.  
  3383.         DeuTex and DeuSF are available on Compuserve, by special
  3384.         request of Dr. Sleep:
  3385.  
  3386.            GAMERS FORUM LIB 8 ACTION GAME AIDS [CIS:GAMERS]
  3387.            PC WORLD FORUM LIB 22 The DOOM ROOM [CIS:PWOFORUM]
  3388.  
  3389.            
  3390.       DeuTex/DeuSF can be made available on any free of charge BBS.
  3391.  
  3392.  
  3393.          Though a freeware tool, DeuTex cannot be distributed
  3394.          by shareware vendors without my written agreement.
  3395.  
  3396.      DeuSF can be freely distributed, because it is meant to help
  3397.      install some PWADs, and thus is not subject to any restrictions.
  3398.  
  3399.  
  3400. You might also want to try:
  3401.  
  3402. NWT by Denis
  3403. A good DOS Tool, easy to use. ideal for making small changes.
  3404. Texture text format compatible with DeuTex.
  3405.  
  3406. DOOMTEX by Steve McCrea
  3407. A list of tools to generate Textures. It's not exactly user friendly,
  3408. but successfully used for TRINITY.WAD. For hackers only :-) I *do* hope
  3409. you'll find DeuTex a bit easier to use, but Steve was a pioneer in the area of Texture editing!
  3410.  
  3411. WACKER by Keith Wilkins
  3412. A Graphic Texture editor. I could not test it, but it should be good.
  3413. It would be a good idea to use it in combination with DeuTex.
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.                                                                    page 45
  3430.  
  3431.  
  3432.                          ---------------------
  3433. D)                        Version Information
  3434.                          ---------------------
  3435.  
  3436. New in version 3.3
  3437.  
  3438. -  Sound formats are not hacked anymore.
  3439.  
  3440. -  Bug corrections and simplifications, for easier maintenance.
  3441.  
  3442.  
  3443. -  Loading of patch is still automatic. I have to do something...
  3444.  
  3445. -  Commands -merge, -app and -join have been improved and securized.
  3446.  
  3447.  
  3448.                              --------------
  3449. E)                           Known Problems
  3450.                              --------------
  3451.  
  3452. -  Color quantization is faster, but optimised for the DOOM and HERETIC
  3453.    palettes supplied with DeuTex. Else, it's slower and a bit lossy.
  3454.  
  3455. -  Identification of entry types does not always work with PWADS made by
  3456.    programs other than DeuTex. There is no general solution to this
  3457.    problem, only my best effort. Sprites and Flats could be missed if
  3458.    certain conventions are not respected. Misidentified entries are
  3459.    stored as Lumps.
  3460.  
  3461. -  GIF format defaults to GIF87.
  3462.  
  3463.  
  3464. -  No MIDI support. MUS format is too complex to understand. No time.
  3465.  
  3466. -  DeuSF does NOT test that all REQUIRED Sprite viewpoints are available
  3467.    if you change the number of viewpoints. DOOM will lock up if you
  3468.    forget one of the Sprite viewpoints.
  3469.  
  3470. -  If the -app command is interrupted, the PWAD file becomes bigger due
  3471.    to appended waste data, but it is still operational.
  3472.  
  3473. -  DeuSF says stupid things if no command is given.
  3474.  
  3475. -  Source is not INCLUDED. It's available to you only if you want to
  3476.    port DeuTex to a new environement. When DeuTex is finished, the
  3477.    source will be released.
  3478.  
  3479.  
  3480.  
  3481. *LIMITATIONS of DOOM
  3482.  
  3483. -  Sprites in PWADs only work if you don't reuse existing Sprites. Use
  3484.    DeuSF or DMADDS if you want to replace Sprites. Actually, DeuTex
  3485.    -merge will also work. (and better!)
  3486.  
  3487. -  Flats don't work in PWADs. Use DeuSF or DMADDS if you want to
  3488.    replace Flats.  Deutex -merge will also work. (and better!)
  3489.  
  3490. *LIMITATIONS of HERETIC
  3491.  
  3492. - Sprites in PWAD don't work at all.  use -merge. I don't know why...
  3493.  
  3494.  
  3495.                                                                  page 46
  3496.  
  3497.  
  3498.  
  3499.  
  3500.                                ------
  3501. F)                             THANKS
  3502.                                ------
  3503.  
  3504.  
  3505. First, thanks to you for taking the time to evaluate DeuTex/DeuSF.
  3506. I know my program is not trivial to use, and might be tricky to
  3507. understand, but I really think it's worth the trouble.
  3508.  
  3509.  
  3510. DeuTex/DeuSF would not have existed without the help of these people:
  3511.  
  3512.  
  3513.    Steve McCrea                   Author of TRINITY.WAD and DOOMTEX.
  3514.  
  3515.    Raphael Quinet                 Examples of GIF and DEU code.
  3516.   (quinet@montefiore.ulg.ac.be)
  3517.  
  3518.    Denis Moller              Author of NWT. Securisation and
  3519.   (denis@doomsday.sh.de)          compatibility of DeuTex and NWT.
  3520.  
  3521.    Elias Papavassilopoulos        Doom technical information.
  3522.   (ep104@cus.cam.ac.uk)
  3523.  
  3524.    Matt Fell                      Doom specs version 1.666
  3525.   (matt.burnet@acebbs.com)
  3526.  
  3527.    Keith Wilkins                  Author of Wacker, first Texture
  3528.   (spike@nectech.demon.co.uk)     composer. Try it!
  3529.  
  3530.    Tom Neff                       Doom technical information.
  3531.   (tneff)
  3532.  
  3533.    Bern Kreismeier                Author of DMADDS/DMADDF
  3534.   (bernd@nero.uni-bonn.de)
  3535.  
  3536.    Dewi Morgan                    Unashamed flattery that lead me to
  3537.   (D.Morgan@bradford.ac.uk)       create DeuSF from DeuTex code.
  3538.  
  3539.    ID software                    For the DEUTEX/DeuSF test bench, also
  3540.   (help@idsoftware.com)           known as 'DOOM', 'DOOM2' or 'HERETIC'
  3541.  
  3542.    Raven software                 For those cool graphics in HERETIC.
  3543.                                   (and for messing with color palettes)
  3544.  
  3545. Special Thanx to:
  3546.  
  3547.  
  3548.    Mark Mathews                   DeuTex OS/2, DJGPP port.
  3549.   (mark.mathews@channel1.com)     Improvements and suggestions.
  3550.  
  3551.    Per Allansson                  DeuTex Linux version.
  3552.   (c91peral@und.ida.liu.se)
  3553.  
  3554.    James Bonfield                 DeuTex DEC ALPHA port
  3555.  
  3556.  
  3557.    Chuck Rossi                    DeuTex SGIx port
  3558.  
  3559.  
  3560.  
  3561.                                                                  page 47
  3562.  
  3563.  
  3564.  
  3565.  
  3566.  
  3567.                          --------------
  3568.                          THANKS (cont.)
  3569.                          --------------
  3570.  
  3571.  
  3572.  
  3573. Thanks to all of you who reported bugs and proposed corrections
  3574. or generally supported my efforts:
  3575.  
  3576.  
  3577.    Leonard Czajka     leonardc@halcyon.halcyon.com
  3578.    Herve.Benvel       Herve.Benvel@inria.fr
  3579.    Paolo Hutchison    paolo@netcom.com
  3580.    M. Kernaghan       mkernagh@julian.uwo.ca
  3581.    Thierry Vermat     vermat@evol10.univ-lyon1.fr
  3582.    Jeremy Blackman    ranma@eskimo.com
  3583.    Jason Mezzacca     72510.3424@compuserve.com
  3584.    C. Gasparo         cgasparo@cymbal.aix.calpoly.edu
  3585.    Avery Andrews      andaling@durras.anu.edu.au
  3586.    (I'm maybe forgetting you!)
  3587.  
  3588.  
  3589.    Thanks to Justin Fisher for letting me use DeuTex and DeuSF on a
  3590.    new install for Alien-TC (despite all the small mistakesI made).
  3591.  
  3592.  Now comes the guy YOU all want to thank:
  3593.  
  3594.      HevKev, also known as Kevin McGrail, novice Manual Editor.
  3595.      74107.1254@compuserve.com
  3596.  
  3597.  
  3598.  Before his contribution, I was the only one who knew how to use DeuTex.
  3599.  Now some of you might understand enough about DeuTex to use it in your
  3600.  great DOOM conversions project.
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.  
  3624.  
  3625.  
  3626.  
  3627.                                                                  page 48
  3628.  
  3629.  
  3630.  
  3631.  
  3632.                              -----------
  3633. G)                           FINAL WORDS
  3634.                               (AT LAST)
  3635.                              -----------
  3636.  
  3637.  
  3638. Thanx for trying DeuTex.
  3639.  
  3640.  
  3641.  I did my best to make it the easy to use, bug free, and portable.
  3642.  However, it's not entirely trivial to use.
  3643.  I can't spend my life on a freeware tool.
  3644.  
  3645.  
  3646.  If you can't understand this tool, chances are your contribution
  3647.  to DOOM fandom will be quite limited. Remember, I only worked to make
  3648.  your life as simple as it could be, so that even non-specialists
  3649.  could produce something cool for DOOM.
  3650.  
  3651.  
  3652.  But don't forget that it takes some time, some dedication, and
  3653.  some genius also, to make something as great as Aliens-TC.
  3654.  
  3655.  
  3656.  
  3657.  
  3658.     Olivier Montanuy,
  3659.  
  3660. E-Mail:
  3661.     montanuy@lannion.cnet.fr      Work time mailbox (avoid)
  3662.     montanuy@dmi.ens.fr           Leisure time mailbox
  3663.     montanuy@idsoftware.com       Dream time mailbox
  3664. Address:
  3665.     Manoir de Keringant, St Quay Perros, 22700 Perros Guirec, FRANCE
  3666.     This is in Bretagne (Brittany), the westernmost part of France.
  3667. Phone:
  3668.     +33 96482047 (time: UTC+1)
  3669.     modem: USR 14400 Worldport LITE Modem Fax.
  3670.         (I'm a real easy frag.)
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.  
  3688.  
  3689.  
  3690.  
  3691.  
  3692.  
  3693.                                                                  page 49
  3694.  
  3695.  
  3696.  
  3697.  
  3698. APPENDIX I   Switch Textures in DOOM.WAD
  3699.  
  3700.  
  3701. SW1BRCOM                128   128
  3702. *     WALL62_1          0     0
  3703. *     SW1S0             48    72
  3704. SW1BRN1                 64    128
  3705. *     WALL02_2          0     56
  3706. *     WALL02_2          0     0
  3707. *     SW3S0             16    75
  3708. SW1BRN2                 64    128
  3709. *     WALL02_2          0     56
  3710. *     WALL02_2          0     0
  3711. *     SW4S0             20    79
  3712. SW1BRNGN                64    128
  3713. *     WALL62_2          0     0
  3714. *     SW4S0             20    80
  3715. SW1BROWN                128   128
  3716. *     WALL62_1          0     0
  3717. *     SW3S1             48    72
  3718. SW1COMM                 64    72
  3719. *     W13_1             0     0
  3720. *     SW1S0             15    18
  3721. SW1COMP                 64    128
  3722. *     COMP03_4          0     64
  3723. *     COMP04_5          0     0
  3724. *     COMP03_4          32    64
  3725. *     SW2S0             16    72
  3726. SW1DIRT                 64    128
  3727. *     WALL00_7          32    0
  3728. *     WALL00_6          16    0
  3729. *     SW1S0             16    20
  3730. *     WALL00_6          0     -16
  3731. *     WALL00_7          48    0
  3732. SW1EXIT                 32    72
  3733. *     W32_4             0     0
  3734. *     SW2S0             0     16
  3735. *     W33_8             0     64
  3736. SW1GRAY                 64    128
  3737. *     W31_1             0     0
  3738. *     W31_1             0     64
  3739. *     SW2S0             16    70
  3740. SW1GRAY1                64    128
  3741. *     W31_1             0     64
  3742. *     W31_1             0     0
  3743. *     SW4S0             19    79
  3744. SW1METAL                64    128
  3745. *     WALL03_7          0     0
  3746. *     WALL03_7          0     64
  3747. *     SW4S0             20    68
  3748. SW1PIPE                 128   128
  3749. *     TP2_2             0     0
  3750. *     SW3S0             48    76
  3751.  
  3752.  
  3753.  
  3754.  
  3755.  
  3756.  
  3757.  
  3758.  
  3759.                                                                  page 50
  3760.  
  3761.  
  3762.  
  3763.  
  3764. SW1SLAD                 64    128
  3765. *     WLA128_1          0     0
  3766. *     WARNB0            24    73
  3767. SW1STARG                128   128
  3768. *     SW19_3            64    0
  3769. *     SW19_4            0     0
  3770. *     SW3S0             48    76
  3771. SW1STON1                64    128
  3772. *     W28_8             0     64
  3773. *     W28_8             0     0
  3774. *     SW1S0             16    78
  3775. SW1STON2                64    128
  3776. *     W28_5             0     0
  3777. *     W28_8             0     64
  3778. *     WARNB0            24    73
  3779. SW1STONE                64    128
  3780. *     WALL01_1          0     0
  3781. *     WALL01_2          16    0
  3782. *     WALL01_3          32    0
  3783. *     WALL01_4          48    0
  3784. *     WALL01_1          0     72
  3785. *     WALL01_2          16    72
  3786. *     WALL01_3          32    72
  3787. *     WALL01_4          48    72
  3788. *     W33_8             0     64
  3789. *     W33_8             0     120
  3790. *     SW1S0             16    72
  3791. SW1STRTN                64    128
  3792. *     SW12_4            0     0
  3793. *     SW12_5            32    0
  3794. *     SW1S0             16    72
  3795. SW2BRCOM                128   128
  3796. *     WALL62_1          0     0
  3797. *     SW1S1             48    72
  3798. SW2BRN1                 64    128
  3799. *     STEP07            32    72
  3800. *     STEP07            0     72
  3801. *     WALL02_2          0     56
  3802. *     WALL02_2          0     0
  3803. *     SW3S1             16    75
  3804. SW2BRN2                 64    128
  3805. *     WALL02_2          0     56
  3806. *     WALL02_2          0     0
  3807. *     SW4S1             20    79
  3808. SW2BRNGN                64    128
  3809. *     WALL62_2          0     0
  3810. *     SW4S1             20    80
  3811. SW2BROWN                128   128
  3812. *     WALL62_1          0     0
  3813. *     SW3S0             48    72
  3814. SW2COMM                 64    72
  3815. *     W13_1             0     0
  3816. *     SW1S1             15    18
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.                                                                  page 51
  3826.  
  3827.  
  3828.  
  3829.  
  3830. SW2COMP                 64    128
  3831. *     COMP03_4          0     64
  3832. *     COMP04_5          0     0
  3833. *     COMP03_4          32    64
  3834. *     SW2S1             16    72
  3835. SW2DIRT                 64    128
  3836. *     WALL00_8          48    0
  3837. *     WALL00_7          32    0
  3838. *     WALL00_6          16    0
  3839. *     WALL00_5          0     -1
  3840. *     SW1S1             16    20
  3841. SW2EXIT                 32    72
  3842. *     W32_4             0     0
  3843. *     SW2S1             0     16
  3844. *     W33_8             0     64
  3845. SW2GRAY                 64    128
  3846. *     W31_1             0     0
  3847. *     W31_1             0     64
  3848. *     SW2S1             16    70
  3849. SW2GRAY1                64    128
  3850. *     W31_1             0     64
  3851. *     W31_1             0     0
  3852. *     SW4S1             19    79
  3853. SW2METAL                64    128
  3854. *     WALL03_7          0     0
  3855. *     WALL03_7          0     64
  3856. *     SW4S1             20    68
  3857. SW2PIPE                 128   128
  3858. *     TP2_2             0     0
  3859. *     SW3S1             48    76
  3860. SW2SLAD                 64    128
  3861. *     WLA128_1          0     0
  3862. *     WARNA0            24    73
  3863. SW2STARG                128   128
  3864. *     SW19_3            64    0
  3865. *     SW19_4            0     0
  3866. *     SW3S1             48    76
  3867. SW2STON1                64    128
  3868. *     W28_8             0     64
  3869. *     W28_8             0     0
  3870. *     SW1S1             16    78
  3871. SW2STON2                64    128
  3872. *     W28_8             0     64
  3873. *     WARNA0            24    73
  3874. *     W28_5             0     0
  3875. SW2STONE                64    128
  3876. *     WALL01_1          0     0
  3877. *     WALL01_2          16    0
  3878. *     WALL01_3          32    0
  3879. *     WALL01_4          48    0
  3880. *     WALL01_1          0     72
  3881. *     WALL01_2          16    72
  3882. *     WALL01_3          32    72
  3883. *     WALL01_4          48    72
  3884. *     W33_8             0     64
  3885. *     W33_8             0     120
  3886. *     SW1S1             16    72
  3887.  
  3888.  
  3889.  
  3890.  
  3891.                                                                  page 52
  3892.  
  3893.  
  3894.  
  3895.  
  3896. SW2STRTN                64    128
  3897. *     SW12_4            0     0
  3898. *     SW12_5            32    0
  3899. *     SW1S1             16    72
  3900. ;
  3901. SW1BLUE                 64    128
  3902. *     COMP03_1          0     0
  3903. *     COMP03_2          0     64
  3904. *     SW2_7             14    66
  3905. SW1CMT                  64    128
  3906. *     WALL54_1          -42   0
  3907. *     SW3S1             16    72
  3908. SW1GARG                 64    128
  3909. *     WALL47_2          0     0
  3910. *     WALL42_6          12    62
  3911. SW1GSTON                64    128
  3912. *     WALL48_2          0     0
  3913. *     SW2_7             13    67
  3914. SW1HOT                  64    128
  3915. *     WALL49_1          0     0
  3916. *     SW2_7             12    66
  3917. SW1LION                 64    128
  3918. *     WALL47_2          0     0
  3919. *     WALL42_5          11    62
  3920. SW1SATYR                64    128
  3921. *     WALL47_2          0     0
  3922. *     WALL42_1          12    62
  3923. SW1SKIN                 64    128
  3924. *     HELL6_3           0     0
  3925. *     SW2_5             0     59
  3926. SW1VINE                 64    128
  3927. *     WALL00_1          0     -16
  3928. *     W106_1            0     0
  3929. *     SW4S0             20    84
  3930. SW1WOOD                 64    128
  3931. *     WALL40_2          -64   0
  3932. *     SW2_7             14    66
  3933. SW2BLUE                 64    128
  3934. *     COMP03_1          0     0
  3935. *     COMP03_2          0     64
  3936. *     SW2_8             14    66
  3937. SW2CMT                  64    128
  3938. *     WALL54_1          -42   0
  3939. *     SW3S0             16    72
  3940. SW2GARG                 64    128
  3941. *     WALL47_2          0     0
  3942. *     WALL47_5          12    62
  3943. SW2GSTON                64    128
  3944. *     WALL48_2          0     0
  3945. *     SW2_8             13    67
  3946. SW2HOT                  64    128
  3947. *     WALL49_1          0     0
  3948. *     SW2_8             12    66
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.                                                                  page 53
  3958.  
  3959.  
  3960.  
  3961.  
  3962. SW2LION                 64    128
  3963. *     WALL47_2          0     0
  3964. *     WALL47_4          11    62
  3965. SW2SATYR                64    128
  3966. *     WALL47_2          0     0
  3967. *     WALL47_3          12    62
  3968. SW2SKIN                 64    128
  3969. *     HELL6_3           0     0
  3970. *     SW2_6             0     59
  3971. SW2VINE                 64    128
  3972. *     WALL00_1          0     -16
  3973. *     W106_1            0     0
  3974. *     SW4S1             20    84
  3975. SW2WOOD                 64    128
  3976. *     WALL40_2          -64   0
  3977. *     SW2_8             14    66
  3978.  
  3979.  
  3980.  
  3981.  
  3982.  
  3983.  
  3984.  
  3985.  
  3986.  
  3987.  
  3988.  
  3989.  
  3990.  
  3991.  
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.  
  4018.  
  4019.  
  4020.  
  4021.  
  4022.  
  4023.                                                                  page 54
  4024.  
  4025.  
  4026.  
  4027.  
  4028. APPENDIX II   Animated Wall Textures in DOOM.WAD
  4029.  
  4030.  
  4031. SLADRIP1                64    128
  4032. *     WALL57_2          0     0
  4033. SLADRIP2                64    128
  4034. *     WALL57_3          0     0
  4035. SLADRIP3                64    128
  4036. *     WALL57_4          0     0
  4037. SLADWALL                64    128
  4038. *     WLA128_1          0     0
  4039. ;
  4040. BLODGR1                 32    128
  4041. *     TP5_1             0     0
  4042. BLODGR2                 32    128
  4043. *     TP5_2             0     0
  4044. BLODGR3                 32    128
  4045. *     TP5_3             0     0
  4046. BLODGR4                 32    128
  4047. *     TP5_4             0     0
  4048. ;
  4049. BLODRIP1                32    128
  4050. *     RP2_1             0     0
  4051. BLODRIP2                32    128
  4052. *     RP2_2             0     0
  4053. BLODRIP3                32    128
  4054. *     RP2_3             0     0
  4055. BLODRIP4                32    128
  4056. *     RP2_4             0     0
  4057. ;
  4058. FIREBLU1                128   128
  4059. *     W65B_1            0     0
  4060. FIREBLU2                128   128
  4061. *     W65B_2            0     0
  4062. ;
  4063. FIRELAV2                128   128
  4064. *     W73A_2            0     0
  4065. FIRELAV3                128   128
  4066. *     W73B_1            0     0
  4067. FIRELAVA                128   128
  4068. *     W73A_1            0     0
  4069. ;
  4070. FIREMAG1                128   128
  4071. *     W74A_1            0     0
  4072. FIREMAG2                128   128
  4073. *     W74A_2            0     0
  4074. FIREMAG3                128   128
  4075. *     W74B_1            0     0
  4076. ;
  4077. FIREWALA                128   112
  4078. *     WALL23_1          0     0
  4079. FIREWALB                128   112
  4080. *     WALL23_2          0     0
  4081. FIREWALL                128   112
  4082. *     WALL22_1          0     0
  4083.  
  4084.  
  4085.  
  4086.  
  4087.  
  4088.  
  4089.                                                                  page 55
  4090.  
  4091.  
  4092.  
  4093.  
  4094. GSTFONT1                64    128
  4095. *     WALL58_1          0     0
  4096. GSTFONT2                64    128
  4097. *     WALL58_2          0     0
  4098. GSTFONT3                64    128
  4099. *     WALL58_3          0     0
  4100. ;
  4101. ROCKRED1                128   128
  4102. *     WALL64_2          0     0
  4103. ROCKRED2                128   128
  4104. *     W64B_1            0     0
  4105. ROCKRED3                128   128
  4106. *     W64B_2            0     0
  4107.  
  4108.  
  4109.  
  4110.  
  4111.  
  4112.  
  4113.  
  4114.  
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.  
  4140.  
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.  
  4148.  
  4149.  
  4150.  
  4151.  
  4152.  
  4153.  
  4154.  
  4155.                                                                  page 56
  4156.  
  4157.  
  4158.  
  4159.  
  4160. APPENDIX III     Listing of Sound Names for DOOM I and II
  4161.  
  4162. *Ripped off from DMGRAPH by Bill Neisius*
  4163. Then corrected and expanded to include DOOM II Sounds for this manual.
  4164. DeuTex uses DOOM's Sound names rather than the artificial Sound numbers
  4165. used in DMGRAPH. A Conversion table for this follows.
  4166.  
  4167. NOTE: An asterisk '*' means the Sound is used for multiple functions.
  4168.  
  4169.                ---------------------------------------
  4170. A)             SOUNDS FOUND IN BOTH DOOM I and DOOM II
  4171.                ---------------------------------------
  4172.  
  4173.      Weapons                                       
  4174.  
  4175. DSPISTOL*    Pistol firing
  4176. DSSGCOCK*    Shotgun cocking
  4177. DSSHOTGN     Shotgun firing (followed by cock)
  4178. DSSAWUP      Chainsaw start
  4179. DSSAWIDL     Chainsaw idle
  4180. DSSAWFUL     Chainsaw with trigger pulled
  4181. DSSAWHIT     Chainsaw hitting monster
  4182. DSRLAUNC     Rocket Launcher firing
  4183. DSBAREXP*    Rocket exploding
  4184. DSFIRSHT     Fireballs shot or passing
  4185. DSFIRXPL*    Fireball hitting object
  4186. DSPUNCH      Player punching
  4187. DSPLASMA     Plasma Gun firing
  4188. DSFIRXPL*    Plasma Round hitting object
  4189. DSBFG        BFG9000 firing
  4190. DSRXPLOD     BFG9000 round exploding
  4191.  
  4192.      Objects
  4193.  
  4194. DSPSTART    Floor/Lift starting
  4195. DSPSTOP     Floor/Lift stops (Clunk)
  4196. DSSTNMOV    Stairs/ceilings moving
  4197. DSDOROPN    Mechanical Door opening
  4198. DSDORCLS    Mechanical Door closing
  4199. DSBDOPN     Fast Door Open
  4200. DSBDCLS     Fast Door Close
  4201. DSSWTCHN*   Switch 'thunk' Sound
  4202. DSSWTCHX    Switch 'pop' Sound
  4203. DSTELEPT    Player/Monster teleport
  4204. DSSLOP      GUTS/SLOP (What the name says)
  4205. DSITMBK     Item Return in MultiPlayer
  4206. DSBAREXP*   Barrel explosion
  4207.  
  4208.      Player
  4209.  
  4210. DSSKLDTH    Player Push on wall
  4211. DSNOWAY     Player blocked by wall
  4212. DSOOF       Player hitting ground
  4213. DSWPNUP     Weapon pickup
  4214. DSITEMUP    Item pickup
  4215. DSGETPOW    Power up Sound (Soul Sphere, etc.)
  4216. DSPLPAIN    Player injured
  4217. DSPLDETH    Player dying scream
  4218. DSPDIEHI    Player higher dying scream
  4219.  
  4220.  
  4221.                                                                 page 57
  4222.  
  4223.  
  4224.  
  4225.  
  4226.      Former Humans
  4227.  
  4228. DSPOSACT    Former Human nearby breathing
  4229. DSPOSIT1    Former Human sees Player
  4230. DSPOSIT2    Former Human sees Player
  4231. DSPOSIT3    Former Human sees Player
  4232. DSPOPAIN*   Former Human injured
  4233. DSPODTH1    Former Human Death Moan
  4234. DSPODTH2    Former Human Death Moan
  4235. DSPODTH3    Former Human Death Yell
  4236.  
  4237.      Imps
  4238.  
  4239. DSBGACT     Imps nearby oinking
  4240. DSBGSIT1    Imp sees Player
  4241. DSBGSIT2    Imp sees Player
  4242. DSCLAW*     Imp clawing Player
  4243. DSPOPAIN*   Imp injured
  4244. DSBGDTH1    Imp dying
  4245. DSBGDTH2    Imp dying
  4246.  
  4247.      Demons/Spectres
  4248.  
  4249. DSSGTSIT    Demon/Spectre sees Player
  4250. DSDMACT*    Demon/Spectre nearby
  4251. DSSGTATK    Demon/Spectre chomping Player
  4252. DSDMPAIN*   Demon/Spectre injured
  4253. DSSGTDTH    Demon/Spectre dying
  4254.  
  4255.      Cacodemons
  4256.  
  4257. DSCACSIT    Cacodemon sees player
  4258. DSDMACT*    Cacodemon nearby
  4259. DSDMPAIN*   Cacodemon injured
  4260. DSCACDTH    Cacodemon dying
  4261.  
  4262.      Barons of Hell
  4263.  
  4264. DSBRSSIT    Baron sees Player
  4265. DSDMACT*    Baron nearby
  4266. DSCLAW*     Baron clawing Player
  4267. DSDMPAIN*   Baron injured
  4268. DSBRSDTH    Baron dying
  4269.  
  4270.      Lost Souls
  4271.  
  4272. DSSKLATK    Lost Soul attacking
  4273. DSDMACT*    Lost Soul nearby
  4274. DSDMPAIN*   Lost Soul injured
  4275. DSFIRXPL*   Lost Soul dying
  4276.  
  4277.      Spider Demon
  4278.  
  4279. DSSPISIT    Spider Demon sees Player
  4280. DSMETAL     Spider Demon walking
  4281. DSSPIDTH    Spider Demon dying
  4282.  
  4283.  
  4284.  
  4285.  
  4286.  
  4287.                                                                  page 58
  4288.  
  4289.  
  4290.  
  4291.  
  4292.      Cyber Demon
  4293.  
  4294. DSCYBSIT    Cyber Demon sees Player
  4295. DSHOOF      Cyber Demon walking
  4296. DSCYBDTH    Cyber Demon dying
  4297.  
  4298.      Miscellaneous
  4299.  
  4300. DSPISTOL*    Menu selections
  4301. DSPISTOL*    Kills, Items, Secrets & Time at end of Level screen
  4302. DSSWTCHN*    Esc to main menu
  4303. DSBAREXP*    Level finished explosion at end of Level screen
  4304. DSSGCOCK*    Proceed to next Level at end of Level screen
  4305. DSTINK      "TINK" To Chat in Modem Play
  4306.  
  4307.  
  4308.                     ----------------------------
  4309. B)                  SOUNDS FOUND ONLY in DOOM II
  4310.                     ----------------------------
  4311.  
  4312.  
  4313.      Weapons
  4314.  
  4315. DSDBOPN     Open Super Shotgun
  4316. DSDBCLS     Close Super Shotgun
  4317. DSDBLOAD    Reload Super Shotgun
  4318. DSDSHTGN    Fire Super Shotgun
  4319.  
  4320.      Revenant
  4321.  
  4322. DSSKESIT    Revenant sees Player    
  4323. DSSKEACT    Revenant nearby
  4324. DSSKEATK    Revenant fires missile
  4325. DSSKESWG    Revenant swings at player
  4326. DSSKEPCH    Revenant punches player
  4327. DSSKEDTH    Revenant dying
  4328.  
  4329.      Mancubis
  4330.  
  4331. DSMANSIT    Mancubis sees Player
  4332. DSMANATK    Mancubis attacks
  4333. DSMNPAIN    Mancubis injured
  4334. DSMANDTH    Mancubis dying
  4335.  
  4336.      Pain Elemental
  4337.  
  4338. DSPESIT     Pain Elemental sees Player
  4339. DSPEPAIN    Pain Elemental injured
  4340. DSPEDTH     Pain Elemental dying
  4341.  
  4342.      Baby Spider
  4343.  
  4344. DSBSPSIT    Baby Spider sees Player
  4345. DSBSPWLK    Baby Spider walking
  4346. DSBSPACT    Baby Spider nearby
  4347. DSBSPDTH    Baby Spider dying
  4348.  
  4349.  
  4350.  
  4351.  
  4352.  
  4353.                                                                 page 59
  4354.  
  4355.  
  4356.  
  4357.  
  4358.      Hell Knight
  4359.  
  4360. DSKNTSIT    Hell Knight sees Player
  4361. DSDMACT*    Hell Knight nearby
  4362. DSCLAW*     Hell Knight clawing Player
  4363. DSDMPAIN*   Hell Knight injured
  4364. DSKNTDTH    Hell Knight dying
  4365.  
  4366.      Arch-Vile
  4367.  
  4368. DSVILSIT    Arch Vile sees Player
  4369. DSVILACT    Arch Vile nearby
  4370. DSVILATK    Arch Vile attacks
  4371. DSFLAMST    Arch-Vile shoots Flame?
  4372. DSFLAME     Arch Vile's Flame arrives
  4373. DSVIPAIN    Arch Vile injured
  4374. DSVILDTH    Arch Vile dying
  4375.  
  4376.      Final Boss
  4377.  
  4378. DSBOSSIT    Final Boss sees Player  'to win the game...' reversed
  4379. DSBOSPIT    Final Boss spits Cube
  4380. DSBOSCUB    Final Boss Cube lands and expands
  4381. DSBOSPN     Final Boss injured
  4382. DSBOSDTH    Final Boss dying
  4383.  
  4384.      Wolfenstein
  4385.  
  4386. DSSSSIT     Wolfenstein SS sees player. 'Schultstaffel'-'SS'
  4387. DSSSDTH     Wolfenstein SS dying. 'mein lieben' -'My Life!'
  4388. DSKEENPN    Commander Keen injured
  4389. DSKEENDT    Commander Keen dying
  4390.  
  4391.      Unknown
  4392.  
  4393. DSRADIO     Phone Sound? Modem play?
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.                                                                  page 60
  4420.  
  4421.  
  4422.  
  4423.  
  4424. +                ----------------------------------
  4425. + C)             CONVERTING DMAUD Sounds for DEUTEX
  4426. +                ----------------------------------
  4427. +
  4428. +
  4429. +
  4430. +  For all you DMAUD users out there, here's a chart you can use to
  4431. +  convert those DMAUD Sound Numbers to DOOM or DEUTEX Sound Names.
  4432. +
  4433. +
  4434. +
  4435. + DMAUD NO.    DEUTEX/DOOM Name
  4436. +
  4437. +
  4438. +     1           DSPISTOL
  4439. +     2           DSSHOTGN
  4440. +     3           DSSGCOCK
  4441. +     4           DSSAWUP
  4442. +     5           DSSAWIDL
  4443. +     6           DSSAWFUL
  4444. +     7           DSSAWHIT
  4445. +     8           DSRLAUNC
  4446. +     9           DSRXPLOD
  4447. +    10           DSFIRSHT
  4448. +    11           DSFIRXPL
  4449. +    12           DSPSTART
  4450. +    13           DSPSTOP
  4451. +    14           DSDOROPN
  4452. +    15           DSDORCLS
  4453. +    16           DSSTNMOV
  4454. +    17           DSSWTCHN
  4455. +    18           DSSWTCHX
  4456. +    19           DSPLPAIN
  4457. +    20           DSDMPAIN
  4458. +    21           DSPOPAIN
  4459. +    22           DSSLOP
  4460. +    23           DSITEMUP
  4461. +    24           DSWPNUP
  4462. +    25           DSOOF
  4463. +    26           DSTELEPT
  4464. +    27           DSPOSIT1
  4465. +    28           DSPOSIT2
  4466. +    29           DSPOSIT3
  4467. +    30           DSBGSIT1
  4468. +    31           DSBGSIT2
  4469. +    32           DSSGTSIT
  4470. +    33           DSBRSSIT
  4471. +    34           DSSGTATK
  4472. +    35           DSCLAW
  4473. +    36           DSPLDETH
  4474. +    37           DSPODTH1
  4475. +    38           DSPODTH2
  4476. +    39           DSPODTH3
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482.  
  4483.  
  4484.  
  4485.                                                                  page 61
  4486.  
  4487.  
  4488.  
  4489.  
  4490. +    40           DSBGDTH1
  4491. +    41           DSBGDTH2
  4492. +    42           DSSGTDTH
  4493. +    43           DSBRSDTH
  4494. +    44           DSPOSACT
  4495. +    45           DSBGACT
  4496. +    46           DSDMACT
  4497. +    47           DSNOWAY
  4498. +    48           DSBAREXP
  4499. +    49           DSPUNCH
  4500. +    50           DSPLASMA
  4501. +    51           DSBFG
  4502. +    52           DSCACSIT
  4503. +    53           DSCYBSIT
  4504. +    54           DSSPISIT
  4505. +    55           DSSKLATK
  4506. +    56           DSCACDTH
  4507. +    57           DSSKLDTH
  4508. +    58           DSCYBDTH
  4509. +    59           DSSPIDTH
  4510. +    60           DSHOOF
  4511. +    61           DSMETAL
  4512.  
  4513.  
  4514.  
  4515.  
  4516.  
  4517.  
  4518.  
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.                                                                 page 62
  4552.  
  4553.  
  4554.  
  4555.  
  4556. APPENDIX IV   DeuTex and DeuSF COMMAND SUMMARIES
  4557.  
  4558.  
  4559.                            ---------------
  4560. A)                         DeuTex COMMANDS
  4561.                            ---------------
  4562.  
  4563. Command Line Format: DEUTEX <-optional cmds.> <-other cmds.>
  4564.  
  4565. ******** 1)  STAND ALONE COMMANDS:
  4566.  
  4567. -dmtextures           Lists the DOOM Textures in TEXTURE?.TXT.
  4568. -check  <myown.wad>   Will look for Textures containing void columns.
  4569. -help                 Lists the parameters.
  4570. -syntax               Prints short listing of the format of WADINFO.TXT.
  4571. -unused <thatlame.wad>   Checks for unused bytes in a PWAD.
  4572.  
  4573. ******** 2) OPTIONAL COMMANDS:
  4574.  
  4575. -doom <doom directory>    Defines the DOOM or DOOM2 directory.
  4576. -dir <working directory>  Defines the working directory.
  4577. -deu*                     Add 64K at the end of your PWAD for DEU.
  4578. -rgb  <R> <G> <B>         Defines the color used for 'transparent'.
  4579.  
  4580. -bmp  \_________________/ Format used when EXTRACTING pictures. DeuTex
  4581. -gif  /                 \ recognizes both when STORING pictures.
  4582. -ppm /
  4583. -wave  \_______________/ Format used when EXTRACTING Sounds. DeuTex
  4584. -au    /               \ recognizes both when INSERTING Sounds).
  4585. -voc  /
  4586. -fullsnd*                 For extracting oversize Sound entries.
  4587.  
  4588. -level  \               / These tell DeuTex to select Sprites, Patches,
  4589. -lump    \             /  Sounds, etc. when composing, decomposing, or 
  4590. -texture  \___________/   merging PWADS. Commands can be combined.
  4591. -sound    /           \   By default, all entries are selected.
  4592. -graphic /             \  Those switches can be combined.
  4593. -sprite /                 
  4594. -patch /
  4595. -flat /
  4596.  
  4597. ******** 3) OTHER COMMANDS:
  4598.      
  4599. -iwad                     Used with -make, makes IWAD instead of a PWAD.
  4600. -wadir <thatcool.wad>     Directory list, with entry identification.
  4601. -get   <entry> <thatcool.wad> Get a single entry from a WAD
  4602. -xtract  <thatcool.wad> \/ Extracts resources from a PWAD and puts them
  4603. -extract <thatcool.wad> /\ into a subdirectory having the resource name.
  4604.  
  4605. -make   <wadinfo.txt> <myown.wad>\  /Reads WADINFO.TXT and uses it to
  4606. -build  <wadinfo.txt> <myown.wad> >< compose MYOWN.WAD from the files
  4607. -create <wadinfo.txt> <myown.wad>/  \in the subdirectories.
  4608.  
  4609. -merge  <myown.wad>      Will merge MYOWN.WAD with DOOM.WAD.
  4610. -restore                 Will restore DOOM.WAD and the merged MYOWN.WAD.
  4611. -join   <myown.wad> <this.wad> Will merge THIS.WAD with MYOWN.WAD
  4612. -app    <myown.wad>            Will append DOOM sprites to MYOWN.WAD
  4613. -res    <myown.wad>            Will restore MYOWN.WAD
  4614.              All these commands are like those of DeuSF
  4615.  
  4616.  
  4617.                                                                  page 63
  4618.  
  4619.  
  4620.  
  4621.  
  4622.                            --------------
  4623. B)                         DeuSF COMMANDS
  4624.                            --------------
  4625.  
  4626.  
  4627. Command Line Format: DeuSF <optional cmds.> <mandatory cmds.>
  4628.  
  4629.  
  4630.  
  4631. ******** 1) STAND ALONE COMMANDS:
  4632.  
  4633.  
  4634. -help                  Lists these parameters.
  4635.  
  4636. -format                Displays format conventions a PWAD must follow.
  4637.  
  4638. -wadir <thatcool.wad>  Lists the entries in the PWAD directory.
  4639.  
  4640.  
  4641. ******** 2) OPTIONAL COMMANDS:
  4642.  
  4643.  
  4644. -doom <doom directory>  Defines the DOOM or DOOM2 directory.
  4645.  
  4646. -sprite   Used with -add or -app, to add only Sprites or only Flats. If
  4647. -flat     neither of these commands is present, DeuSF will add both.
  4648.  
  4649.  
  4650. ******** 3) MANDATORY COMMANDS:
  4651.  
  4652.  
  4653. -add  <myown.wad> <allsf.wad>  Creates ALLSF.WAD, with all Sprites and
  4654.                                Flats of DOOM.WAD and MYOWN.WAD.
  4655.  
  4656. -app  <myown.wad>              Appends unchanged DOOM Sprites and Flats
  4657.                                to MYOWN.WAD.
  4658.  
  4659. -join <this.wad> <that.wad>    Appends the Sprites and Flats in THAT.WAD
  4660.                                to THIS.WAD.
  4661.  
  4662. -res <myown.wad>               Restores PWAD modified with -app command.
  4663.  
  4664. -merge  <myown.wad>            Like DeuTex
  4665.  
  4666. -restore                       Like DeuTex
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.                                                                  page 64
  4684.  
  4685.  
  4686.  
  4687.  
  4688. AFTERWORD
  4689.  
  4690.                       TRINITY.WAD: HOW I MADE IT.
  4691.                  For lost drunken men who no longer know
  4692.          where they are, but DO care. (Cell #2)
  4693.                               Steve McCrea
  4694.                    <<FIRST DRAFT 8th September 1994>>
  4695.  
  4696. -----------------------------------------------------------------------
  4697.  
  4698.                This information is published with DeuTex
  4699.                    with permission from Steve McCrea
  4700.  
  4701.               This file is a bit obsolete. Get the last
  4702.                   version directly from Steve McCrea.
  4703.  
  4704.  
  4705.  
  4706. -----------------------------------------------------------------------
  4707.  
  4708. I am writing this article in response to numerous inquiries about the
  4709. techniques used in the creation of Trinity, and in particular a direct
  4710. request from Ian Mapleson. It is in no way intended as a textbook
  4711. approach, and I accept no responsibility for any time wasted as a
  4712. result of following the procedures documented here. I may stray from
  4713. the subject matter from time to time, as I said to the producer last
  4714. week... Although titled "How I Made It", this may not be strictly true.
  4715. I leave it as an exercise to the reader to determine which bits have
  4716. been glossed over for clarity.
  4717.  
  4718. LEVEL DESIGN
  4719.  
  4720. As with all design, it is important to have the right tools and be
  4721. familiar with them. I restricted myself unnecessarily at this early
  4722. stage by only downloading DEU. I think this was a big mistake.  The
  4723. other editors out there may well have some great features I missed out
  4724. on totally. I know, for instance, that at least one of the others
  4725. supports auto stair construction. But since I didn't get the others, I
  4726. don't know what else is available to speed design.  My recommendation
  4727. for those starting out in WAD design is to get them all, find out which
  4728. does what best and then mix and match. You may find yourself using one
  4729. for most of the layout and then just switching quickly to another to do
  4730. some trick or other. Hopefully you won't get too confused!
  4731.  
  4732. Before I started on Trinity, I had designed a few mini-levels in DEU.
  4733. The first was just one room, then I did a couple of Wolfenstein levels,
  4734. and so on. This got all the big mistakes out of the way, such as
  4735. overlaying lines and vertices, splitting sectors wrongly, and losing
  4736. work because DEU crashed. Then I laid out the courts in Trinity from
  4737. memory, and ran about in Doom checking that the scale felt right.
  4738. Initially there was an area surrounding the college but I dropped it
  4739. because it was going to be boring, and the map was huge anyway.  I left
  4740. most walls the standard texture, and only added things like wood for
  4741. gates. Having satisfied the sense of scale, I put in most of the rooms
  4742. and passages, and added rough doors.
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.                                                                  page 65
  4750.  
  4751.  
  4752.  
  4753.  
  4754. SCANNING PHOTOGRAPHS
  4755.  
  4756. About this time, I realized that it would be doing the college an
  4757. injustice to use the standard Doom textures. I decided to scan some
  4758. photographs of the college and put them in, so I borrowed Peter
  4759. Morgan's (thanks Pete) camera on a sunny day and wandered over to
  4760. Trinity. I tried to make the photographs I took clear from
  4761. obstruction, shadow free and square to the viewer, i.e., with as
  4762. little distortion as possible. I then scanned standard sized 6"x4"
  4763. prints at on average 150dpi with Bill Milne's (thanks Bill) color
  4764. scanner. I used Adobe PhotoShop on Bill's Mac to straighten the
  4765. images and crop off what I was sure I didn't need, but I DIDN'T
  4766. change the resolution or convert from 24 bit color and I DIDN'T
  4767. crop right up to the edges of what I wanted.
  4768.  
  4769. This was AFTER the test run on the Wren library, the southern upper
  4770. wall of the southwest courtyard (NOTE: Apologies to those who know
  4771. Trinity: yes, I have rotated the college 90 degrees!), when I scaled
  4772. the image to 64x256 and saved it as an 8 bit GIF. If you look
  4773. carefully at the texture in the level, you will see that it is now
  4774. 128 wide, scaled from 64!  Yech. I wasn't going to make that mistake
  4775. again, although I couldn't be bothered to rescan the Wren library.
  4776.  
  4777. When I was pretty sure what size I wanted for graphics, I COPIED
  4778. the images, cropped, scaled, tinted, smoothed, converted to GIF, and
  4779. so on.  Some graphics didn't tile very well, and I either touched
  4780. them up to tile properly (e.g., stone) or mirrored one half (e.g.,
  4781. the windows on the outside of the dining hall).
  4782.  
  4783. There are three hand drawn graphics in Trinity: the sky, plaster, and
  4784. the burgundy wood paneling. Again I started with a 24 bit palette,
  4785. and used the pencil and airbrush tools before blending, motion
  4786. blurring, tinting etc. to produce the final image. Several edit
  4787. cycles were required to get something that I was (sort of) happy with
  4788. in Doom.
  4789.  
  4790. TALL WALLS
  4791.  
  4792. The standard Doom texture is a maximum of 128 pixels high, and on walls
  4793. higher than this the texture repeats vertically. Clearly I didn't want
  4794. this in Trinity, so I use a couple of tricks to avoid it. On walls with
  4795. void space behind (no sector behind) a sector is added with floor and
  4796. ceiling heights chosen to divide the wall into sections less than 128
  4797. high. (Notice that I say _less_ than 128 high. Initially you might
  4798. think, as I did, that 128 high would be perfect. However, if there is a
  4799. substantial color change from top to bottom of a texture then, as in
  4800. Trinity, glitches appear on the walls at the dividing lines due to
  4801. round off in the vertical texture mapping.)
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.                                                                  page 66
  4816.  
  4817.  
  4818.  
  4819.  
  4820.     _____________
  4821.    /   added     \
  4822.   /    sector     \
  4823. ---------------------
  4824.     tall wall
  4825.               ----------------- top of wall
  4826.         |           upper texture
  4827.         |         ----------------- ceiling of added sector
  4828.         +---->      normal texture
  4829.               ----------------- floor of added sector
  4830.                 lower texture
  4831.               ----------------- bottom of wall
  4832.  
  4833. Textures are applied as shown. The line between the sectors is marked
  4834. as 2S/Im/So in DEU, i.e., two sided, impassable, and blocks sound. The
  4835. blocks sound bit is to reduce the size of the REJECT data. See the
  4836. unofficial specs for details. The impassable bit is to prevent you or
  4837. monsters going into the sector (I had this problem with skulls
  4838. initially. It was disturbing to find skulls appearing from nowhere!).
  4839. The normal texture must be a single patch or the Medusa effect (looks
  4840. like snakes and you turn to stone) will occur.
  4841.  
  4842. In Doom, each texture is constructed from one or more graphics patches.
  4843. The texture definition contains no image data, just the size of the
  4844. texture, and a list of patches and their position in the texture. The
  4845. _patch_ definition contains the image data. For walls which already had
  4846. sectors behind them (e.g., above a doorway) non-repeating tall textures
  4847. are achieved by "stepping" the wall. A separate sector is required for
  4848. each step. In side view,
  4849.  
  4850.         ------- ceiling
  4851.          |
  4852.          |<-- top texture
  4853.          |
  4854.         -
  4855.        |
  4856.        |<-- middle texture
  4857.        |
  4858. ---------
  4859.  
  4860.     doorway
  4861. ------------------- floor
  4862.  
  4863. This is not as neat as the other method because the ceiling texture of
  4864. the sector between the top and middle textures will always be visible,
  4865. and must be chosen to minimize breaking up the look of the wall. It is
  4866. also harder to add because the sector should clearly be very thin (in
  4867. Trinity they are 2 units thick) and this is very fiddly work away from
  4868. the autogrid.
  4869.  
  4870.  
  4871.  
  4872.  
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.  
  4880.  
  4881.                                                                  page 67
  4882.  
  4883.  
  4884.  
  4885.  
  4886. GRAPHICS ADDITION
  4887.  
  4888. Initially I just replaced patches in single patch textures. I hacked
  4889. around with DMGRAPH to make it convert a GIF directly to a patch.
  4890. Then I used a program I had previously written for sound lumps to
  4891. make a PWAD of patches with names the same as the names of patches in
  4892. single patch textures. These then replaced the same-named patches
  4893. when the PWAD is included using -file.
  4894.  
  4895. However a better solution was necessary as (a) I was running out of
  4896. single patch textures, and (b) I needed some user defined multipatch
  4897. textures. So I wrote a program to convert the texture definition
  4898. entries in the main Doom WAD to an ASCII format, and another which
  4899. recreated the binary definition entries from the ASCII format. The
  4900. big advantage of this method was that it allowed the creation of NEW
  4901. textures with sensible names like "stone" and "plaster". A typical
  4902. definition of a new texture "doorcrst", a 128x128 texture with
  4903. three old patches and one new:
  4904.  
  4905. DOORCRST 128 128
  4906. *            door11_1 4 0
  4907. *            door11_1 124 0
  4908. *            door11_1 -116 0
  4909. *            pcrest4 46 37
  4910.  
  4911. For textures to repeat properly when the length is greater than the
  4912. width of the texture, the width should be a power of two. For some
  4913. reason, the "aastinky" texture in Doom is 24 units wide. The last
  4914. eight columns of the graphic will never be seen (but they're not
  4915. very exciting anyway).
  4916.  
  4917. The first released version of Trinity had redefined switch textures,
  4918. so that when the switch was encountered later in the standard levels,
  4919. it looked really bad. In the second version I fixed this by setting
  4920. the switches into walls so that only the switch part of the texture
  4921. was visible. This is _highly_ recommended for levels which may be
  4922. grouped into PWAD episodes.
  4923.  
  4924.  
  4925.        old switch texture
  4926.            | 
  4927.            v
  4928.          x--------x <-- thin sector with 'metal' textures
  4929.   -----x---x--------x---x-----
  4930.        ^            ^    wall
  4931.        |            |
  4932.        +------------+------ new switch surround
  4933.  
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.  
  4941.  
  4942.  
  4943.  
  4944.  
  4945.  
  4946.  
  4947.                                                                  page 68
  4948.  
  4949.  
  4950.  
  4951.  
  4952. Actually it's just occurred to me that there is a neater, if more
  4953. memory hungry, way to do this seamlessly. Widen the switch texture
  4954. and put the new switch on the right of the old one, then when using
  4955. your new switch offset the texture by the appropriate amount. As
  4956. long as no other levels use a repeated switch on a wall, then this
  4957. is perfect. For example, say you wanted a new switch pair, you could
  4958. tack them on the right of the SW1BRN1 and SW2BRN1 switch pair. The
  4959. original definition of SW1BRN1 is
  4960. SW1BRN1 64 128
  4961. *            wall02_2 0 56
  4962. *            wall02_2 0 0
  4963. *            sw3s0 16 75
  4964. which you redefine to be
  4965. SW1BRN1 256 128
  4966. *            wall02_2 192 56
  4967. *            wall02_2 192 0
  4968. *            wall02_2 64 56
  4969. *            wall02_2 64 0
  4970. *            wall02_2 0 56
  4971. *            wall02_2 0 0
  4972. *            sw3s0 16 75
  4973. *            pplast 96 0
  4974. *            pplast 160 0
  4975. *            sw3s0 144 75
  4976.  
  4977. The old switch is still at offset 0. The new switch is at offset 128.
  4978. Note the repetition of the wall patch. This allows for roundoff error
  4979. in the texture mapping engine, which expects similar texture to be
  4980. just to the left and just to the right of the texture being drawn.
  4981. Don't forget to define the other switch position SW2BRN1 similarly!
  4982. This technique allows for a large number of different switch designs
  4983. to be used in a PWAD. Not that I'm condoning the use of a large
  4984. number of switches in PWADs - in fact, some of the best PWADs are
  4985. totally ruined by switches everywhere. (No Return01s, I mean names,
  4986. mentioned. Speaking of which, which I'm not of course, did you know
  4987. that there are two graphics added to Return to Phobos? Switches!
  4988. Both of them! Good grief, Michael! _Beautiful_ WAD, but...)
  4989.  
  4990. Note: remember to make the textures a power of two wide if you want to
  4991. allow for roundoff.
  4992.  
  4993.  
  4994. [ The program used for trinity was DOOMTEX, available as dmtex10c.zip
  4995. [ DeuTex is easier to use that DOOMTEX, which was brilliant, but some
  4996. [ kind of hack, with no securities. DeuTex can do all DOOMTEX did.
  4997.  
  4998.  
  4999.  
  5000.  
  5001.  
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.                                                                 page 69
  5014.  
  5015.  
  5016.  
  5017.  
  5018. THE "ANIMATION"
  5019.  
  5020. If you haven't seen Trinity.WAD, I recommend you look at it before
  5021. reading this section as it contains a massive spoiler. However if you
  5022. haven't seen Trinity you probably aren't reading this document (?!?),
  5023. so...
  5024.  
  5025. Several people have asked how the cyberdemon movie is done. I have
  5026. even heard it described as "voodoo magic"! Nothing could be further
  5027. from the truth. It is actually very simple. To quote Matt Fell in
  5028. the unofficial Doom specs 1.3,
  5029.  
  5030.      "It is possible to change the walls and floors that are
  5031. animated, like the green blocks with a sewer-like grate that's
  5032. spewing green slime (SLADRIPx). The game engine sets up as many as 8
  5033. animation cycles for walls based on the entries in the TEXTURE
  5034. resources, and up to 5 based on what's between F_START and F_END. The
  5035. entries in FirstTexture and LastTexture, below, and all the entries
  5036. between them (in the order that they occur in a TEXTURE list), are
  5037. linked. If one of them is called by a sidedef, that sidedef will
  5038. change texture to the next in the cycle about 5 times a second,
  5039. going back to First after Last. Note that the entries between First
  5040. and Last need not be the same in number as in the original, nor do
  5041. they have to follow the same naming pattern, though that would
  5042. probably be wise. E.g. one could set up ROCKRED1, ROCKREDA, ROCKREDB,
  5043. ROCKREDC, ROCKREDD, ROCKREDE, ROCKRED3 for a 7-frame animated wall!"
  5044.  
  5045. Hence the movie in Trinity is defined in the ASCII texture file as a
  5046. series of textures SLADRIP1, MOVIE01, MOVIE02, ..., MOVIE98,
  5047. SLADRIP3. The important thing is the order in which the textures
  5048. are listed. The Doom EXE contains the names of the FirstTextures
  5049. and LastTextures so it isn't possible to have additional animation
  5050. cycles in a PWAD.
  5051.  
  5052. And because the Sprites and the Doom logo have the same format
  5053. as patches, they are just listed as if they were patches. For
  5054. example, a frame of the movie is defined
  5055.  
  5056. MOVIE08 256 128
  5057. *            pblak 0 0
  5058. *            pblak 64 0
  5059. *            pblak 128 0
  5060. *            pblak 192 0
  5061. *            t 67 40
  5062. *            r 86 40
  5063. *            i 106 40
  5064. *            n 124 40
  5065. *            i 144 40
  5066. *            t 162 40
  5067. *            y 181 40
  5068. *            m_doom 67 50
  5069. *            cybre7 -20 20
  5070. *            playf3f7 198 64
  5071.  
  5072. where "pblak" is a totally black patch, and t, r, i, n, and y are
  5073. the characters. Initially, the movie used the character set in the
  5074. game but this caused crashes (for a reason I won't go into now) so
  5075. after consulting ID, I included the character set again in the PWAD
  5076. with new names.
  5077.  
  5078.  
  5079.                                                                 page 70
  5080.  
  5081.  
  5082.  
  5083.  
  5084. The technique described in the Graphics Addition section for adding
  5085. new switches can also be applied to new animated textures. Just
  5086. make the new animation length a multiple of the old length, and
  5087. put the old animation at the left of the textures. Don't forget to
  5088. satisfy the roundoff errors! You could squeeze twenty or more thin
  5089. animations into a large texture!
  5090.  
  5091. THE SKY
  5092.  
  5093. You may not have noticed, but the sky in the latest version of Trinity
  5094. doesn't repeat anywhere around the horizon. (Thanks to Olivier
  5095. Montanuy, author of DeuTex, for teaching me this trick.) This is done
  5096. by defining a sky texture (SKY1, SKY2, or SKY3 depending on the
  5097. episode) which is 1024x128 in size, and pasting patches into it so
  5098. that 0=East, 256=North, 512=West, and 768=South. Note that this means
  5099. that the textures are left/right mirrored! I can't think of any way
  5100. to make the sky texture animated. However you could fake twin skies
  5101. by only allowing the player to see half the sky during one part of a
  5102. level, and then later only allowing him to see the other half! A
  5103. crap example would be bright blue skies -> red skies+mushroom cloud.
  5104. It's probably a good idea to disorient the player in between with,
  5105. for example, a teleport, so he doesn't catch on to the trick too
  5106. quickly.
  5107.  
  5108. CONCLUSION
  5109.  
  5110. In this document I have outlined some techniques which can be used to
  5111. seemingly extend the Doom engine. The use of these inevitably slows
  5112. down Doom and so should be used sparingly, unless you _really_ need
  5113. (well, really _want_, anyway) the effect.
  5114.  
  5115. If you're about to start your first big WAD, collect together as many
  5116. tools as you can, and read all the documentation you can find,
  5117. particularly the Unofficial specs. Good luck!
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.  
  5124.  
  5125.  
  5126.  
  5127.  
  5128.  
  5129.  
  5130.  
  5131.  
  5132.  
  5133.  
  5134.  
  5135.  
  5136.  
  5137.  
  5138.  
  5139.  
  5140.  
  5141.  
  5142.  
  5143.  
  5144.  
  5145.                                                                 page 71
  5146.